PtData is an MCP server published by io.ptdata, hosted at api.ptdata.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 4 tools, including get_index_constituents, get_fundamentals, get_filing_metadata, get_earnings_event.
Point-in-time US equity fundamentals for quants and AI agents. Free tier, no API key needed.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
S&P 500 (or other index) constituents as understood on `as_of_date` (YYYY-MM-DD), survivorship-free. Point-in-time, with lineage.
| Parameter | Type | Description |
|---|---|---|
| index * | string | |
| as_of_date * | string |
{
"name": "get_index_constituents",
"title": "Get index constituents",
"description": "S&P 500 (or other index) constituents as understood on `as_of_date` (YYYY-MM-DD),\nsurvivorship-free. Point-in-time, with lineage.",
"inputSchema": {
"type": "object",
"required": [
"index",
"as_of_date"
],
"properties": {
"index": {
"type": "string"
},
"as_of_date": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"title": "Get index constituents",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Point-in-time fundamentals for `ticker` as known on `as_of_date` (YYYY-MM-DD). Returns each available metric's value for the fiscal period with source + knowledge time + lineage under `metrics`. Any requested metric with no value appears under `unavailable` with `{reason, code, available_alternatives, docs_url}` instead of being silently dropped. `code` is `not_reported` or `financials_family`. `revenue` keeps the headline tag first filed for that period (including `RevenuesNetOfInterestExpense` for brokers and card issuers) and follows that tag's own restatements. A later tag does not replace it, and components are not summed. A financial with only component lines gets `financials_family` and the populated members. Check `unavailable` before concluding a figure does not exist. `cost_of_revenue` keeps the cost tag first filed for the period. Candidate order is CostOfRevenue, CostOfGoodsAndServicesSold, CostOfGoodsSold, CostOfServices. An empty higher-priority tag does not block a later tag. Product cost and service cost are not added together. `eps_basic` is EarningsPerShareBasic. `ebit` is not a us-gaap tag. A missing Q2 or Q3 operating-cash-flow or capex quarter can be a year-to-date difference. A missing Q4 flow quarter can be FY minus Q1, Q2, and Q3, with provenance "derived" and a `derivation` object. EPS and share counts are not derived. Balance-sheet Q4 is the FY instant.
| Parameter | Type | Description |
|---|---|---|
| ticker * | string | |
| metrics * | array | |
| as_of_date * | string | |
| fiscal_year | any | |
| fiscal_period | string |
{
"name": "get_fundamentals",
"title": "Get point-in-time fundamentals",
"description": "Point-in-time fundamentals for `ticker` as known on `as_of_date` (YYYY-MM-DD).\nReturns each available metric's value for the fiscal period with source + knowledge time +\nlineage under `metrics`. Any requested metric with no value appears under `unavailable` with\n`{reason, code, available_alternatives, docs_url}` instead of being silently dropped. `code` is\n`not_reported` or `financials_family`. `revenue` keeps the headline tag first filed for that\nperiod (including `RevenuesNetOfInterestExpense` for brokers and card issuers) and follows\nthat tag's own restatements. A later tag does not replace it, and components are not summed.\nA financial with only component lines gets `financials_family` and the populated members.\nCheck `unavailable` before concluding a figure does not exist.\n`cost_of_revenue` keeps the cost tag first filed for the period. Candidate order is\nCostOfRevenue, CostOfGoodsAndServicesSold, CostOfGoodsSold, CostOfServices. An empty\nhigher-priority tag does not block a later tag. Product cost and service cost are not\nadded together. `eps_basic` is EarningsPerShareBasic. `ebit` is not a us-gaap tag.\nA missing Q2 or Q3 operating-cash-flow or capex quarter can be a year-to-date difference.\nA missing Q4 flow quarter can be FY minus Q1, Q2, and Q3, with provenance \"derived\" and a\n`derivation` object. EPS and share counts are not derived. Balance-sheet Q4 is the FY instant.",
"inputSchema": {
"type": "object",
"required": [
"ticker",
"as_of_date",
"metrics"
],
"properties": {
"ticker": {
"type": "string"
},
"metrics": {
"type": "array",
"items": {
"type": "string"
}
},
"as_of_date": {
"type": "string"
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"fiscal_period": {
"type": "string",
"default": "FY"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"title": "Get point-in-time fundamentals",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}SEC filings for `ticker` available on `as_of_date`, newest first, with amendment linkage.
| Parameter | Type | Description |
|---|---|---|
| ticker * | string | |
| form_type | any | |
| as_of_date * | string |
{
"name": "get_filing_metadata",
"title": "Get filing metadata",
"description": "SEC filings for `ticker` available on `as_of_date`, newest first, with amendment linkage.",
"inputSchema": {
"type": "object",
"required": [
"ticker",
"as_of_date"
],
"properties": {
"ticker": {
"type": "string"
},
"form_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"as_of_date": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"title": "Get filing metadata",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Earnings event: 8-K acceptance timestamp, and as-reported revenue and eps_gaap from the original report. `fiscal_year` and `fiscal_period` are required. `fiscal_period` is FY, or Q1–Q3. A fourth-quarter release is stored as FY. This tool does not take as_of_date.
| Parameter | Type | Description |
|---|---|---|
| ticker * | string | |
| fiscal_year * | integer | |
| fiscal_period * | string |
{
"name": "get_earnings_event",
"title": "Get earnings event",
"description": "Earnings event: 8-K acceptance timestamp, and as-reported revenue and eps_gaap from the\noriginal report. `fiscal_year` and `fiscal_period` are required. `fiscal_period` is FY, or\nQ1–Q3. A fourth-quarter release is stored as FY. This tool does not take as_of_date.",
"inputSchema": {
"type": "object",
"required": [
"ticker",
"fiscal_year",
"fiscal_period"
],
"properties": {
"ticker": {
"type": "string"
},
"fiscal_year": {
"type": "integer"
},
"fiscal_period": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"title": "Get earnings event",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}PtData is a point-in-time US equity database: fundamentals, index constituents, SEC filing metadata, and earnings events. get_fundamentals, get_index_constituents, and get_filing_metadata take as_of_date (YYYY-MM-DD) and return only what was public on that date. get_earnings_event takes ticker, fiscal_year, and fiscal_period (FY, or Q1–Q3) and does not take as_of_date. A requested fundamental with no value is returned under unavailable with a reason, not omitted.
Names, descriptions and schemas were written by the server and are shown as data.