xyz.iposignal/iposignal

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

IPO deal terms, SEC filings, AI research and sentiment, plus live valuation metrics for US stocks.

Add to your agent

Copy this into your MCP client config:

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

Measured tools (10)

• get_ipo_overview read-only

  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.

  Parameters:

  • cik — string — SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042.
  • symbol — string — US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.
  • companyId — string — IPOSignal company id (24-character hex), as returned by other IPOSignal responses.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lookup_companies_with_financials read-only

  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).

  Parameters:

  • limit — integer — Page size, 1-500. Defaults to 200.
  • query — string — Filter by ticker or company name (case-insensitive substring). Omit to list every covered company.
  • offset — integer — Rows to skip. Pass the previous response's nextOffset to fetch the next page.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_ipo_pipeline read-only

  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.

  Parameters:

  • limit — integer — Maximum deals to return, 1-500. Defaults to 100.
  • since — string — Withdrawn/postponed only: earliest status date to include, YYYY-MM-DD. Defaults to one year ago.
  • status — string — upcoming (filed, not trading yet), withdrawn, or postponed. Defaults to upcoming.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_ipo_filings read-only

  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.

  Parameters:

  • cik — string — SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042.
  • symbol — string — US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.
  • companyId — string — IPOSignal company id (24-character hex), as returned by other IPOSignal responses.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_ipo_snapshot read-only

  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}.

  Parameters:

  • cik — string — SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042.
  • symbol — string — US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.
  • companyId — string — IPOSignal company id (24-character hex), as returned by other IPOSignal responses.

  Hints: read-only yes · destructive no · idempotent no · open-world no

• get_company_financials read-only

  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}.

  Parameters:

  • symbol (required) — string — US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.

  Hints: read-only yes · destructive no · idempotent no · open-world no

• get_company_metrics read-only

  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.

  Parameters:

  • symbol — string — Any SEC-mapped US ticker, e.g. AAPL. Provide exactly one of symbol or companyName.
  • companyName — string — Company name, used when the ticker is unknown. Resolves Nasdaq/NYSE listings only.

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• get_ipo_sentiment read-only

  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.

  Parameters:

  • days — integer — Trend window in days, 1-90. Defaults to 14.

  Hints: read-only yes · destructive no · idempotent no · open-world no

• get_ipo_social_sentiment read-only

  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.

  Parameters:

  • cik — string — SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042.
  • symbol — string — US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.
  • companyId — string — IPOSignal company id (24-character hex), as returned by other IPOSignal responses.

  Hints: read-only yes · destructive no · idempotent no · open-world no

• get_ipo_events read-only

  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.

  Parameters:

  • to — string — Window end, YYYY-MM-DD, inclusive and at most 366 days after from. Defaults to from + 30 days.
  • from — string — Window start, YYYY-MM-DD (UTC date). Defaults to today.
  • types — array — Event types to include: lockup_expiry (with lock-up length), quiet_period_expiry, listing (with first-day pop, close return and lead managers). Defaults to all three.

  Hints: read-only yes · destructive no · idempotent no · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.