xyz.iposignal/iposignal

Official8 tools

by Waltermelon-lang

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

xyz.iposignal/iposignal — Model Context Protocol (MCP) Server

The xyz.iposignal/iposignal MCP server provides access to IPO deal terms and SEC filings, along with AI research and sentiment data and live valuation metrics for US stocks.

🛠️ Key Features

IPO deal terms
SEC filings
AI research and sentiment
Live valuation metrics for US stocks

🚀 Use Cases

Reviewing IPO deal terms alongside related SEC filings
Using AI research and sentiment to contextualize US stock valuation
Checking live valuation metrics for US stocks during analysis

⚡ Developer Benefits

Single MCP source for IPO terms, SEC filings, AI research/sentiment, and valuation metrics
Developer-friendly organization aligned to IPO and US stock monitoring workflows

⚠️ Limitations

No additional capabilities, tool list, or configuration details are provided in the available source data

Topics

a2afintechipomcpmcp-serverx402

Captured live from the server via tools/list.

get_ipo_overview

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "companyId": {
      "type": "string",
      "description": "IPOSignal company id (24-character hex), as returned by other IPOSignal responses."
    },
    "symbol": {
      "type": "string",
      "description": "US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote."
    },
    "cik": {
      "type": "string",
      "description": "SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

lookup_companies_with_financials

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

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Filter by ticker or company name (case-insensitive substring). Omit to list every covered company."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 200,
      "description": "Page size, 1-500. Defaults to 200."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Rows to skip. Pass the previous response's nextOffset to fetch the next page."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ipo_snapshot

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

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "companyId": {
      "type": "string",
      "description": "IPOSignal company id (24-character hex), as returned by other IPOSignal responses."
    },
    "symbol": {
      "type": "string",
      "description": "US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote."
    },
    "cik": {
      "type": "string",
      "description": "SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_company_financials

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

Parameters1

symbol

string

required

US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote."
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_company_metrics

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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Any SEC-mapped US ticker, e.g. AAPL. Provide exactly one of symbol or companyName."
    },
    "companyName": {
      "type": "string",
      "description": "Company name, used when the ticker is unknown. Resolves Nasdaq/NYSE listings only."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ipo_sentiment

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.

Parameters1

days

integer

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "default": 14,
      "description": "Trend window in days, 1-90. Defaults to 14."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ipo_social_sentiment

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "companyId": {
      "type": "string",
      "description": "IPOSignal company id (24-character hex), as returned by other IPOSignal responses."
    },
    "symbol": {
      "type": "string",
      "description": "US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote."
    },
    "cik": {
      "type": "string",
      "description": "SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ipo_events

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.

Parameters3

from	string	optional	Window start, YYYY-MM-DD (UTC date). Defaults to today.
to	string	optional	Window end, YYYY-MM-DD, inclusive and at most 366 days after from. Defaults to from + 30 days.
types	array	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Window start, YYYY-MM-DD (UTC date). Defaults to today."
    },
    "to": {
      "type": "string",
      "description": "Window end, YYYY-MM-DD, inclusive and at most 366 days after from. Defaults to from + 30 days."
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "lockup_expiry",
          "quiet_period_expiry",
          "listing"
        ]
      },
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md4 KBView on GitHub

IPOSignal — MCP server, A2A agent card, x402 API

Machine-readable IPO intelligence from iposignal.xyz: deal terms, SEC filings, AI research, proprietary market and social sentiment, and live valuation metrics for any US-listed company.

Three ways in, all against the same data:

Surface	Endpoint	Auth	Cost
MCP	`https://iposignal.xyz/api/mcp`	none	free
A2A	`https://iposignal.xyz/.well-known/agent-card.json`	none	discovery free, calls priced below
HTTP + x402	`https://iposignal.xyz/api/agent/*`	none	pay-per-request in USDC on Base

No accounts, no API keys, no rate-limit tiers. This repo holds the public metadata, connection docs and examples — the product source is private.

MCP server

Streamable HTTP. Free and ungated: the MCP surface mirrors the paid HTTP endpoints at no cost.

bash

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

Or in a client config:

json

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

Tools (4)

Tool	Returns
`get_ipo_snapshot`	Full IPO company profile — deal terms, pricing range, expected market cap, SEC registration and prospectus details, offering structure, lifecycle timeline, IBKR indicative borrow fee. Includes AI research with valuation models, competitor benchmarking, underwriter ratings, board analysis and risk factors where available. One of `companyId`, `symbol` or `cik`.
`get_ipo_sentiment`	Proprietary daily IPO-market sentiment score, −100 (extreme bearish) to +100 (extreme bullish), with trend over the last N days. Identifies favourable IPO windows and overall appetite for new listings.
`get_company_metrics`	Live valuation metrics for any US-listed company, not just IPOs: SEC XBRL companyfacts TTM fundamentals plus latest close → P/E, P/S, EV/Revenue, EV/EBITDA, PEG, linear yields, net-debt/EBITDA, margins, YoY growth. One of `symbol` or `companyName`.
`get_ipo_social_sentiment`	Aggregate X/Twitter sentiment for a specific IPO, −1 to +1, with label, post tallies and a one-line summary. Aggregate signal only, not the underlying posts.

Test it live in the Glama MCP inspector by pasting the endpoint URL.

A2A agent card

Served at both paths during the spec transition:

https://iposignal.xyz/.well-known/agent-card.json — current spec
https://iposignal.xyz/.well-known/agent.json — legacy (v0.2 and earlier)

Discovery manifest: https://iposignal.xyz/api/a2a

Six skills, one free (lookup_companies_with_financials), five paid via x402.

Paying with x402

Endpoints under /api/agent/* are machine-payable using the open x402 protocol. USDC on Base mainnet (eip155:8453).

Call the endpoint. Unpaid requests return HTTP 402 with a PAYMENT-REQUIRED header describing price, asset, network and recipient.
Your x402 client signs the payment and retries with a PAYMENT-SIGNATURE header.
The payment is verified and settled on-chain, then the data returns with a PAYMENT-RESPONSE settlement header.

Prices

Live values are always in the agent card under payment.prices — read them there rather than hardcoding.

Endpoint	Price
`GET /api/agent/companies?q={query}`	free
`GET /api/agent/ipo/by-symbol/{symbol}`	$0.01
`GET /api/agent/financials/by-symbol/{symbol}`	$0.01
`GET /api/agent/company-metrics?symbol={symbol}`	$0.02
`GET /api/agent/ipo-sentiment`	$0.01
`GET /api/agent/social-sentiment?symbol={symbol}`	$0.01

See examples/ for a runnable paid call and an MCP call.

Install

Tools (8)

get_ipo_overviewlookup_companies_with_financialsget_ipo_snapshotget_company_financialsget_company_metricsget_ipo_sentimentget_ipo_social_sentimentget_ipo_events

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://iposignal.xyz/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "iposignal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://iposignal.xyz/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

xyz.iposignal/iposignal

xyz.iposignal/iposignal — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_ipo_overview

lookup_companies_with_financials

get_ipo_snapshot

get_company_financials

get_company_metrics

get_ipo_sentiment

get_ipo_social_sentiment

get_ipo_events

IPOSignal — MCP server, A2A agent card, x402 API

MCP server

Tools (4)

A2A agent card

Paying with x402

Prices

Links

Install

Remote endpoint

Related servers