Server definition
- Hash
- sha256:1a1e33a8b0f03a7b1de77770436aa141bda740a18f9e2ced1b31780fda1fd503
- What it is
- What a remote MCP server returned when asked what it offers: 15 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Keys changed in a dataset since a feed position. Requires a valid key. Costs 0 credits. Every response's `meta.position` says how far into the change log its data goes, 404s included. To start, copy what you need and keep the smallest `meta.position` you saw as your `since`. To catch up, page through `/v1/changes?dataset=…&since=…` following `next_cursor`, fetch each added or changed key and delete each removed one, then set `since` to the smallest of the feed's `meta.to` and the `meta.position` of every response you just fetched, 404s included. A 404 on a fetch means that key isn't served yet; when the `company` feed later lists that company as added, fetch all its datasets. If a fetch fails with anything other than 200 or 404, or its `meta.position` is null, don't move `since`: fetch it again later. A 404 `since_unknown` or 409 `full_copy_required` means start again with a full copy. Changes are kept 90 days. If every response says `meta.position` is null, the change log isn't running yet: copy again in full once it is a number. This carries no figures. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"type": "string"
},
"dataset": {
"enum": [
"metrics",
"company",
"statements",
"ownership",
"macro",
"insider",
"form13f",
"filings",
"normalized",
"segments",
"holders",
"earnings"
],
"type": "string"
},
"limit": {
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"since": {
"pattern": "^[0-9]+$",
"type": "string"
}
},
"required": [
"dataset",
"since"
],
"type": "object"
},
"name": "get_changes",
"outputSchema": null
},
{
"description": "One company by ticker or CIK. Costs 1 credit. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "A ticker in any case (BRK.B and BRK-B reach the same company) or a CIK with or without leading zeros.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_company",
"outputSchema": null
},
{
"description": "One 8-K Item 2.02 earnings release with its plain-text exhibit body. Costs 5 credits. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"accession": {
"description": "SEC accession number (##########-##-######).",
"type": "string"
},
"id": {
"description": "Ticker or CIK.",
"type": "string"
}
},
"required": [
"id",
"accession"
],
"type": "object"
},
"name": "get_earnings_release",
"outputSchema": null
},
{
"description": "Filings list from SEC submissions, newest first. One page only via limit/cursor. Costs 3 credits. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The meta.next_cursor of the previous page.",
"type": "string"
},
"id": {
"description": "Ticker or CIK.",
"type": "string"
},
"limit": {
"description": "Records per page (1–50, default 20).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_filings",
"outputSchema": null
},
{
"description": "Normalized core financials from printed statement lines (published fields only), newest period first. One page via limit/cursor. Costs 1 credit. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The meta.next_cursor of the previous page.",
"type": "string"
},
"field": {
"description": "One published field.",
"enum": [
"revenue",
"net_income",
"diluted_eps",
"cash_and_equivalents",
"total_assets",
"total_liabilities",
"total_equity",
"operating_cash_flow",
"investing_cash_flow",
"financing_cash_flow",
"basic_eps",
"weighted_diluted_shares",
"operating_income",
"research_development",
"income_tax",
"current_assets",
"current_liabilities",
"receivables",
"ppe_net",
"retained_earnings",
"gross_profit",
"sga",
"pretax_income",
"intangibles",
"accounts_payable",
"goodwill",
"net_income_attributable",
"equity_attributable",
"inventory",
"short_term_debt",
"stock_compensation",
"capital_expenditure",
"total_interest_income",
"net_interest_income",
"noninterest_income",
"net_revenue"
],
"type": "string"
},
"id": {
"description": "Ticker or CIK.",
"type": "string"
},
"limit": {
"description": "Facts per page (1–100, default 40).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"period": {
"description": "annual or quarterly.",
"enum": [
"annual",
"quarterly"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_financials",
"outputSchema": null
},
{
"description": "Form 13F holdings for a manager CIK. value_unit is thousands_usd or usd; ticker is null unless proven. One page only. Not part of the free demo: charged even for demo companies. Costs 3 credits. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The meta.next_cursor of the previous page.",
"type": "string"
},
"id": {
"description": "Manager ticker or CIK.",
"type": "string"
},
"limit": {
"description": "Records per page (1–50, default 20).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_form13f",
"outputSchema": null
},
{
"description": "Who holds this issuer on Form 13F for one period (newest by default). By default one record per manager, ranked by shares, with the manager's filing link and the number of rows behind each total, so \"who holds the most\" is one call (limit=10 for a top ten). view=positions returns the raw 13F rows instead; sort=value ranks by checked value. Options and convertible principal are kept apart from shares; amendments are resolved so a manager is not counted twice; a value that a filing's own evidence cannot settle is left out and flagged, never guessed. Managers are filers: related filers (two Vanguard entities) stay separate, and shares of different managers are never added together. About 35% of 13F rows lack dual-evidence CIK links and are left out. An empty list explains itself in meta.empty_reason; SEC publishes the 13F data sets in three-month windows, so the newest quarter is not there until its window closes. Costs 3 credits. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The meta.next_cursor of the previous page.",
"type": "string"
},
"id": {
"description": "Issuer ticker or CIK.",
"type": "string"
},
"limit": {
"description": "Managers (or positions) per page (1–100, default 25).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"period": {
"description": "Report period end YYYY-MM-DD.",
"type": "string"
},
"sort": {
"description": "Ranking for managers: shares (default) or value.",
"enum": [
"shares",
"value"
],
"type": "string"
},
"view": {
"description": "managers (default): one ranked record per manager. positions: every 13F row for the period.",
"enum": [
"managers",
"positions"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_holders",
"outputSchema": null
},
{
"description": "Form 3/4/5 insider transactions for an issuer, newest first. Blank price is null. One page only via limit/cursor. Costs 3 credits. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The meta.next_cursor of the previous page.",
"type": "string"
},
"id": {
"description": "Ticker or CIK of the issuer.",
"type": "string"
},
"limit": {
"description": "Records per page (1–50, default 20).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_insider_trades",
"outputSchema": null
},
{
"description": "One official macro series document (BLS, Treasury par yields, Fed H.15). Unknown series are refused. Costs 1 credit. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"series": {
"description": "Official macro series id (BLS, Treasury par tenors, Fed H.15).",
"enum": [
"cpi_u_all_items_sa",
"cpi_u_core_sa",
"ppi_final_demand_sa",
"nonfarm_payrolls_sa",
"avg_hourly_earnings_private_sa",
"labor_force_participation_sa",
"unemployment_rate_sa",
"treasury_par_3m",
"treasury_par_2y",
"treasury_par_10y",
"treasury_par_30y"
],
"type": "string"
}
},
"required": [
"series"
],
"type": "object"
},
"name": "get_macro",
"outputSchema": null
},
{
"description": "Key metrics for a company, newest period first. Unknown query parameters are refused. Without metric, the five headline metrics; a bank's income lines (total_interest_income, net_interest_income, noninterest_income, net_revenue) come only when named. For a bank, net_revenue is the usual revenue measure. Costs 1 credit. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"frequency": {
"description": "annual or quarterly.",
"enum": [
"annual",
"quarterly"
],
"type": "string"
},
"id": {
"description": "Ticker or CIK.",
"type": "string"
},
"metric": {
"description": "One metric key. Bank lines are served for banks and lenders only.",
"enum": [
"revenue",
"net_income",
"diluted_eps",
"operating_cash_flow",
"cash_and_equivalents",
"total_interest_income",
"net_interest_income",
"noninterest_income",
"net_revenue"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_metrics",
"outputSchema": null
},
{
"description": "Schedule 13D/13G reporting-owner records for an issuer, newest filing first. Structured XML filings from 2024-12-18 only. Costs 3 credits. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"form": {
"description": "Filing form, such as SCHEDULE 13G or SCHEDULE 13D/A.",
"type": "string"
},
"id": {
"description": "Ticker or CIK of the issuer.",
"type": "string"
},
"limit": {
"description": "Records per page (1–100, default 20).",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_ownership",
"outputSchema": null
},
{
"description": "Single-axis product, geographic and business-segment revenue. Multi-axis and expense lines are not served. One page via limit/cursor. Costs 3 credits. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"axis": {
"description": "One target axis name.",
"enum": [
"ProductOrService",
"ProductsAndServices",
"Producttype",
"BusinessLine",
"Geographical",
"GeographicalAreas",
"GeographicDistribution",
"BusinessSegments",
"Segments",
"Subsegments"
],
"type": "string"
},
"cursor": {
"description": "The meta.next_cursor of the previous page.",
"type": "string"
},
"id": {
"description": "Ticker or CIK.",
"type": "string"
},
"limit": {
"description": "Documents per page (1–50, default 20).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"period_end": {
"description": "Filing period end YYYY-MM-DD.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_segments",
"outputSchema": null
},
{
"description": "Statements as filed, one document per filing and statement, newest filing first. Costs 3 credits. One page only: pass `limit` (1–20, default 4) and `cursor` from `meta.next_cursor`. Do not assume every page is fetched. A typical page of 4 documents is about 45 KB (median in the pilot sample); large pages stay under the API document budget (~4 MB). A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The meta.next_cursor of the previous page.",
"type": "string"
},
"form": {
"description": "Filing form, such as 10-K or 10-Q.",
"type": "string"
},
"id": {
"description": "Ticker or CIK.",
"type": "string"
},
"limit": {
"description": "Documents per page (1–20, default 4).",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"statement": {
"description": "BS, IS, CF, or CI.",
"enum": [
"BS",
"IS",
"CF",
"CI"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_statements",
"outputSchema": null
},
{
"description": "8-K Item 2.02 press-release exhibits for an issuer, newest filed first. List items omit text (a document page). Titles may be null. One page via limit/cursor; optional from/to on filed. Costs 3 credits. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The meta.next_cursor of the previous page.",
"type": "string"
},
"from": {
"description": "Inclusive filed lower bound YYYY-MM-DD.",
"type": "string"
},
"id": {
"description": "Ticker or CIK.",
"type": "string"
},
"limit": {
"description": "Releases per page (1–100, default 20).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"to": {
"description": "Inclusive filed upper bound YYYY-MM-DD.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "list_earnings_releases",
"outputSchema": null
},
{
"description": "Data age for metrics, statements, ownership, and macro. Costs 0 credits. Authenticated on the hosted connector like every other tool; the underlying /v1/status route itself needs no key. A figure can be withheld (null/absent beats a guess). A figure can change or disappear when a later filing arrives; figures are not versioned. Read `adjustments` for extractor decisions beyond copying one filed figure. This is filing data, not investment advice.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "status",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:1a1e33a8b0f03a7b1de77770436aa141bda740a18f9e2ced1b31780fda1fd503 | sha256sum