IPOSignal for Agents

Machine-payable IPO intelligence. Pay per request in USDC on Base via the open x402 protocol — no account needed — or use a subscriber API key. MCP and A2A discovery included.

Every metric is modeled in its economic regime, not fed in raw — valuation ratios like P/S are handled in log space (a sky-high multiple ≈ near-zero sales), and signed metrics like margins are sign-aware so a single extreme value can't distort the signal. You get numbers that mean what they should.

Agent card (JSON)A2A discovery MCP endpoint

Available endpoints

Endpoint	Access	Path
Companies lookup Directory of companies we have SEC financials for — discover available tickers. Paged with ?limit= (max 500) and ?offset=; see total and nextOffset.	Free	GET /api/agent/companies?q={query}
Company financials SEC iXBRL income/balance/cash-flow line items + derived margins, growth, leverage, ROE/ROA.	Paid	GET /api/agent/financials/by-symbol/{symbol}
Company metrics (live) Any US-listed company, not just IPOs: SEC XBRL TTM fundamentals + latest close → P/E, P/S, EV/Revenue, EV/EBITDA, PEG, linear yields, net-debt/EBITDA, margins, YoY growth. Computation convention stated in every response.	Paid	GET /api/agent/company-metrics?symbol={symbol} \| ?name={company}
IPO snapshot Full company profile: deal terms, AI research, valuation, competitors, registration.	Paid	GET /api/agent/ipo/by-symbol/{symbol}
IPO market sentiment Proprietary daily sentiment score (−100 to +100) for new-listing appetite.	Paid	GET /api/agent/ipo-sentiment
Social sentiment Aggregate X/Twitter sentiment for a specific IPO (score, label, tallies).	Paid	GET /api/agent/social-sentiment?symbol={symbol}
IPO events Lock-up expiries, quiet-period expiries and listings with first-day pop, close return and lead managers, across all US IPOs in a date window (up to 366 days).	Paid	GET /api/agent/ipo-events?from={YYYY-MM-DD}&to={YYYY-MM-DD}&types={types}

MCP server

The same intelligence as an MCP server over streamable HTTP — no account needed. Free tools identify a deal; premium tools are paid per call over x402 at the same price as the HTTP endpoints, or covered by a subscriber API key (below), and a not-found is never charged. Point any MCP client at https://iposignal.xyz/api/mcp.

Tool	Tier	What it returns
get_ipo_overview	free	FREE. The public facts of an IPO: company, ticker, CIK, exchange, listing date, shares offered, price range, final offer price when the deal has priced, and gross proceeds. Use it to identify a deal before buying the full profile with get_ipo_snapshot. Provide exactly one of companyId, symbol, or cik.
lookup_companies_with_financials	free	FREE. Directory of companies we hold SEC iXBRL financial statements for, optionally filtered by ticker or company name. Returns ticker, company, CIK, latest reported period and pre/post-IPO period counts — use it to find which tickers get_company_financials can return. Paged: limit (default 200, max 500) and offset; the response carries total and nextOffset (null on the last page).
get_ipo_snapshot	premium	Retrieve a complete IPO company profile — deal terms, pricing range, expected market cap, SEC registration and prospectus details, offering structure, lifecycle timeline, and IBKR indicative borrow fee rate when available. When available, includes AI-generated research with valuation models, competitor benchmarking, underwriter ratings, board analysis, and risk factors. Provide exactly one of companyId, symbol, or cik. PREMIUM: paid per call over x402 (USDC on Base); an unpaid call returns the payment terms, and a not-found is never charged. Same data and price as the HTTP endpoint /api/agent/ipo/{id} or /api/agent/ipo/by-symbol/{symbol}.
get_ipo_sentiment	premium	Access IPOSignal's proprietary market sentiment score — a daily signal quantifying how well recent IPOs are being received by investors. Ranges from -100 (extreme bearish) to +100 (extreme bullish) with trend data for the last N days. Use it to identify favorable IPO windows, time investment entries, and assess overall market appetite for new listings. PREMIUM: paid per call over x402 (USDC on Base); an unpaid call returns the payment terms, and a not-found is never charged. Same data and price as the HTTP endpoint /api/agent/ipo-sentiment.
get_company_metrics	premium	Get live valuation metrics for any US-listed company (not just IPOs), computed from primary sources: SEC XBRL companyfacts TTM fundamentals (revenue, net income, EBITDA, debt, cash, shares) plus the latest market close. Returns multiples (P/E, P/S, EV/Revenue, EV/EBITDA), derivations (PEG, earnings/sales/EBITDA yields, net-debt/EBITDA), margins, and YoY growth — the same data IPOSignal's valuation pipeline uses for peer benchmarking, with the computation convention stated in the response. Provide exactly one of symbol (any SEC-mapped ticker) or companyName (resolves Nasdaq/NYSE listings). PREMIUM: paid per call over x402 (USDC on Base); an unpaid call returns the payment terms, and a not-found is never charged. Same data and price as the HTTP endpoint /api/agent/company-metrics.
get_company_financials	premium	Retrieve full SEC iXBRL financial statements for a company we cover, pre- and post-IPO, with derived margins, growth, leverage and return ratios per period. Interim periods carry annualized figures alongside the reported ones. Provide a symbol. PREMIUM: paid per call over x402 (USDC on Base); an unpaid call returns the payment terms, and a not-found is never charged. Same data and price as the HTTP endpoint /api/agent/financials/by-symbol/{symbol}.
get_ipo_social_sentiment	premium	Get IPOSignal's X/Twitter social-sentiment reading for a specific IPO — an aggregate of how investors are discussing the stock on X, scored from -1 (bearish) to +1 (bullish) with a label, post tallies, and a one-line summary. The reading is taken once, before listing, and not refreshed: `ageDays` says how old it is and `reliable` is false when too few posts back it. Returns the aggregate signal only, not the underlying posts. Provide exactly one of companyId, symbol, or cik. PREMIUM: paid per call over x402 (USDC on Base); an unpaid call returns the payment terms, and a not-found is never charged. Same data and price as the HTTP endpoint /api/agent/social-sentiment.
get_ipo_pipeline	free	FREE. The US IPO pipeline: operating companies that have filed with the SEC but are not trading yet (status upcoming), or deals that were withdrawn or postponed. Each row has company, ticker when assigned, CIK, exchange, expected trading date when one is scheduled, the date of the latest status change, price range, shares offered, Nasdaq's deal size, and a link to the latest SEC filing. Status is the one the iposignal.xyz calendar shows, so SPACs and other vehicles are excluded. Use it to see what is coming to market or what was pulled; follow up with get_ipo_filings for one company's filing history or get_ipo_snapshot for the full deal profile. Arguments: status (upcoming, withdrawn or postponed; default upcoming), since as YYYY-MM-DD for withdrawn/postponed (default one year ago), limit (default 100, max 500). Upcoming deals sort by expected date, undated last.
get_ipo_filings	free	FREE. One company's SEC filing timeline as we hold it, newest first: form type (S-1, S-1/A, F-1, F-1/A, EFFECT, 424B4, RW, 8-K, ...), filing date, and the link to the document on sec.gov. Use it to follow a registration from first S-1 through amendments to the final prospectus, or to confirm a withdrawal (RW). Covers the filings our SEC syncs collected for the company, not every filing it ever made. Provide exactly one of companyId, symbol, or cik.
get_ipo_events	premium	Dated IPO events across all US IPOs in a window: lock-up expiries (with lock-up length), quiet-period expiries, and listings with offer price, first-day open and close, first-day pop and close return versus the offer, and lead managers. Use it to find upcoming lock-up expiries (supply overhang), quiet-period ends (analyst initiations) or how recent deals traded on day one. Arguments: from and to as YYYY-MM-DD (default today to today + 30 days, at most 366 days), types as a subset of lockup_expiry, quiet_period_expiry, listing (default all). PREMIUM: paid per call over x402 (USDC on Base); an unpaid call returns the payment terms, and an empty window is never charged. Same data and price as the HTTP endpoint /api/agent/ipo-events.

Claude Code

claude mcp add --transport http iposignal https://iposignal.xyz/api/mcp

Client config

{
  "mcpServers": {
    "iposignal": {
      "type": "streamable-http",
      "url": "https://iposignal.xyz/api/mcp"
    }
  }
}

How payment works

Call a paid endpoint. If unpaid, it returns HTTP 402 with a PAYMENT-REQUIRED header describing the price, asset (USDC), network (Base), and recipient.
Your x402 client signs the payment and retries with a PAYMENT-SIGNATURE header.
We verify via the x402 facilitator and return the data, with a PAYMENT-RESPONSE settlement header.

API keys (subscribers)

No wallet? A subscription includes 10,000 calls a month to every paid endpoint and premium MCP tool. Create a key on your account page and send it as a bearer token. Only delivered results count; past the quota, calls fall back to pay-per-call x402. The remaining quota is in the X-API-Quota-Remaining response header.

curl -H "Authorization: Bearer ips_live_…" https://iposignal.xyz/api/agent/ipo-events?types=lockup_expiry

claude mcp add --transport http iposignal https://iposignal.xyz/api/mcp --header "Authorization: Bearer ips_live_…"