Server definition
- Hash
- sha256:19a13f60f88bccee50734387455876da10e6fcd767dd5f7af6378a0bfe3ccd1b
- What it is
- What a remote MCP server returned when asked what it offers: 8 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "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}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"symbol": {
"description": "US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_company_financials",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"cik": {
"description": "SEC Central Index Key.",
"type": [
"string",
"null"
]
},
"company": {
"description": "Registrant name.",
"type": [
"string",
"null"
]
},
"fetchedAt": {
"description": "When the statements were last extracted from SEC.",
"type": [
"string",
"null"
]
},
"postIpoPeriods": {
"anyOf": [
{
"items": {
"$ref": "#/properties/preIpoPeriods/anyOf/0/items"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Periods from 10-K/10-Q/20-F filings after listing."
},
"preIpoPeriods": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"properties": {
"annualizedMetrics": {
"anyOf": [
{
"additionalProperties": {
"type": [
"number",
"null"
]
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Interim periods only: flow items annualized to 12 months."
},
"currency": {
"description": "Reporting currency.",
"type": [
"string",
"null"
]
},
"derived": {
"anyOf": [
{
"additionalProperties": {
"type": [
"number",
"null"
]
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Computed ratios: margins, growth, leverage, returns."
},
"durationMonths": {
"description": "Length of the period in months.",
"type": [
"number",
"null"
]
},
"fxToUsd": {
"description": "Multiply by this to convert to USD.",
"type": [
"number",
"null"
]
},
"metrics": {
"anyOf": [
{
"additionalProperties": {
"type": [
"number",
"null"
]
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Tagged line items as reported (revenue, net income, cash, debt, ...)."
},
"periodEndDate": {
"description": "YYYY-MM-DD.",
"type": [
"string",
"null"
]
},
"periodStartDate": {
"description": "YYYY-MM-DD.",
"type": [
"string",
"null"
]
},
"periodType": {
"description": "Annual or interim, as filed.",
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Periods reported in the registration statement, before listing."
},
"symbol": {
"description": "Ticker.",
"type": [
"string",
"null"
]
},
"symbolNote": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Present only when the requested ticker is contested: which registrant it belongs to now vs. the record served."
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"companyName": {
"description": "Company name, used when the ticker is unknown. Resolves Nasdaq/NYSE listings only.",
"type": "string"
},
"symbol": {
"description": "Any SEC-mapped US ticker, e.g. AAPL. Provide exactly one of symbol or companyName.",
"type": "string"
}
},
"type": "object"
},
"name": "get_company_metrics",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"convention": {
"description": "How the figures were computed.",
"type": [
"string",
"null"
]
},
"fundamentalsTtm": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Trailing-twelve-month revenue, net income, EBITDA, FCF, debt, cash, shares outstanding (and sharesSource), from SEC XBRL."
},
"listing": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "ticker, name, exchange, cik."
},
"priceClose": {
"description": "Latest market close, USD.",
"type": [
"number",
"null"
]
},
"profile": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Margins and YoY growth."
},
"sources": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Where each input came from."
},
"valuation": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "marketCap, enterpriseValue, P/E, P/S, EV/Revenue, EV/EBITDA, PEG, yields, net-debt/EBITDA."
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"from": {
"description": "Window start, YYYY-MM-DD (UTC date). Defaults to today.",
"type": "string"
},
"to": {
"description": "Window end, YYYY-MM-DD, inclusive and at most 366 days after from. Defaults to from + 30 days.",
"type": "string"
},
"types": {
"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.",
"items": {
"enum": [
"lockup_expiry",
"quiet_period_expiry",
"listing"
],
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "get_ipo_events",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"count": {
"description": "Events returned.",
"type": [
"number",
"null"
]
},
"events": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"properties": {
"cik": {
"description": "SEC Central Index Key.",
"type": [
"string",
"null"
]
},
"company": {
"description": "Registrant name.",
"type": [
"string",
"null"
]
},
"date": {
"description": "YYYY-MM-DD.",
"type": [
"string",
"null"
]
},
"exchange": {
"description": "Listing exchange.",
"type": [
"string",
"null"
]
},
"listing": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Listing events only: offer price, first-day pop, close return, lead managers."
},
"lockupDays": {
"description": "Lock-up length in days (lockup_expiry only).",
"type": [
"number",
"null"
]
},
"symbol": {
"description": "Ticker.",
"type": [
"string",
"null"
]
},
"type": {
"description": "lockup_expiry, quiet_period_expiry or listing.",
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Events in date order."
},
"from": {
"description": "Window start, YYYY-MM-DD.",
"type": [
"string",
"null"
]
},
"to": {
"description": "Window end, YYYY-MM-DD, inclusive.",
"type": [
"string",
"null"
]
},
"types": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Event types included."
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cik": {
"description": "SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042.",
"type": "string"
},
"companyId": {
"description": "IPOSignal company id (24-character hex), as returned by other IPOSignal responses.",
"type": "string"
},
"symbol": {
"description": "US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.",
"type": "string"
}
},
"type": "object"
},
"name": "get_ipo_overview",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"cik": {
"description": "SEC Central Index Key, 10 digits.",
"type": [
"string",
"null"
]
},
"company": {
"description": "Registrant name.",
"type": [
"string",
"null"
]
},
"ipoDetails": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Public deal facts: date, exchange, shares offered, priceRange, offerPrice (final terms only), offerSize (gross proceeds). No valuation."
},
"premium": {
"description": "What get_ipo_snapshot adds.",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Ticker.",
"type": [
"string",
"null"
]
},
"symbolNote": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Present only when the requested ticker is contested: which registrant it belongs to now vs. the record served."
},
"venue": {
"description": "Listing exchange.",
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"days": {
"default": 14,
"description": "Trend window in days, 1-90. Defaults to 14.",
"maximum": 90,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_ipo_sentiment",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"current": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"computedAt": {
"description": "ISO timestamp.",
"type": [
"string",
"null"
]
},
"date": {
"description": "YYYY-MM-DD.",
"type": [
"string",
"null"
]
},
"direction": {
"description": "bullish, bearish or neutral.",
"type": [
"string",
"null"
]
},
"reliable": {
"description": "False when the sample is too small to trust.",
"type": [
"boolean",
"null"
]
},
"sampleSize": {
"description": "IPOs the score is computed from.",
"type": [
"number",
"null"
]
},
"score": {
"description": "-100 (extreme bearish) to +100 (extreme bullish).",
"type": [
"number",
"null"
]
},
"strength": {
"description": "weak, moderate or strong.",
"type": [
"string",
"null"
]
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Latest daily reading."
},
"summary": {
"description": "One-line reading of level and direction.",
"type": [
"string",
"null"
]
},
"trend": {
"anyOf": [
{
"items": {
"$ref": "#/properties/current/anyOf/0"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Daily readings, newest first."
}
},
"type": "object"
}
},
{
"description": "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}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cik": {
"description": "SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042.",
"type": "string"
},
"companyId": {
"description": "IPOSignal company id (24-character hex), as returned by other IPOSignal responses.",
"type": "string"
},
"symbol": {
"description": "US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.",
"type": "string"
}
},
"type": "object"
},
"name": "get_ipo_snapshot",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"borrowFee": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Latest IBKR indicative borrow fee (annualized %), when available."
},
"cik": {
"description": "SEC Central Index Key, 10 digits.",
"type": [
"string",
"null"
]
},
"company": {
"description": "Registrant name.",
"type": [
"string",
"null"
]
},
"freedom24News": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Freedom24 articles about the deal."
},
"ipoDetails": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Deal facts: date, exchange, shares offered, priceRange, offerPrice (final terms only), marketCap (post-IPO economic shares × offer price), offerSize (gross proceeds), and the source of each."
},
"lifecycleEvents": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"properties": {},
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Dated status history: filed, priced, listed, withdrawn."
},
"offering": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Offering structure from the prospectus; termsAreFinal is true only for a final 424B* prospectus."
},
"registration": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "SEC registration statement: form type and filing URL."
},
"research": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "AI-generated research: valuation models, competitors, underwriters, board, risks. Figures are sourced from filings."
},
"sec": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "SEC company data."
},
"symbol": {
"description": "Ticker.",
"type": [
"string",
"null"
]
},
"symbolNote": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Present only when the requested ticker is contested: which registrant it belongs to now vs. the record served."
},
"updatedAt": {
"description": "ISO timestamp of the last update to this record.",
"type": [
"string",
"null"
]
},
"venue": {
"description": "Listing exchange.",
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cik": {
"description": "SEC Central Index Key, with or without leading zeros, e.g. 1876042 or 0001876042.",
"type": "string"
},
"companyId": {
"description": "IPOSignal company id (24-character hex), as returned by other IPOSignal responses.",
"type": "string"
},
"symbol": {
"description": "US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.",
"type": "string"
}
},
"type": "object"
},
"name": "get_ipo_social_sentiment",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"ageDays": {
"description": "Days since the reading. Readings are taken before listing and not refreshed.",
"type": [
"number",
"null"
]
},
"analyzedAt": {
"description": "ISO timestamp of the reading.",
"type": [
"string",
"null"
]
},
"company": {
"description": "Registrant name.",
"type": [
"string",
"null"
]
},
"label": {
"description": "Bullish, Neutral or Bearish.",
"type": [
"string",
"null"
]
},
"negativeHits": {
"description": "Posts scored negative.",
"type": [
"number",
"null"
]
},
"positiveHits": {
"description": "Posts scored positive.",
"type": [
"number",
"null"
]
},
"postCount": {
"description": "Posts the reading is based on.",
"type": [
"number",
"null"
]
},
"reliable": {
"description": "False when too few posts back the reading.",
"type": [
"boolean",
"null"
]
},
"score": {
"description": "-1 (bearish) to +1 (bullish).",
"type": [
"number",
"null"
]
},
"summary": {
"description": "One-line summary.",
"type": [
"string",
"null"
]
},
"symbol": {
"description": "Ticker.",
"type": [
"string",
"null"
]
},
"symbolNote": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"type": "object"
},
{
"type": "null"
}
],
"description": "Present only when the requested ticker is contested: which registrant it belongs to now vs. the record served."
}
},
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"default": 200,
"description": "Page size, 1-500. Defaults to 200.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Rows to skip. Pass the previous response's nextOffset to fetch the next page.",
"minimum": 0,
"type": "integer"
},
"query": {
"description": "Filter by ticker or company name (case-insensitive substring). Omit to list every covered company.",
"type": "string"
}
},
"type": "object"
},
"name": "lookup_companies_with_financials",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": true,
"properties": {
"count": {
"description": "Rows in this page.",
"type": [
"number",
"null"
]
},
"data": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"properties": {
"cik": {
"description": "SEC Central Index Key.",
"type": [
"string",
"null"
]
},
"company": {
"description": "Registrant name.",
"type": [
"string",
"null"
]
},
"latestPeriodEnd": {
"description": "End date of the latest reported period, YYYY-MM-DD.",
"type": [
"string",
"null"
]
},
"postIpoCount": {
"description": "Reporting periods after the IPO.",
"type": [
"number",
"null"
]
},
"preIpoCount": {
"description": "Reporting periods before the IPO.",
"type": [
"number",
"null"
]
},
"symbol": {
"description": "Ticker.",
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Companies we hold SEC iXBRL financials for."
},
"limit": {
"description": "Page size.",
"type": [
"number",
"null"
]
},
"nextOffset": {
"description": "Offset of the next page, or null on the last page.",
"type": [
"number",
"null"
]
},
"offset": {
"description": "Rows skipped.",
"type": [
"number",
"null"
]
},
"total": {
"description": "Rows matching the query across all pages.",
"type": [
"number",
"null"
]
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:19a13f60f88bccee50734387455876da10e6fcd767dd5f7af6378a0bfe3ccd1b | sha256sum