Verify Fact Lineage
verify_fact_lineageVerify the provenance of a financial data point by its deterministic fact_id hash. Returns the full lineage chain: entity, concept, period, value, the SEC filing accession ID, and the source filing URL. Use this tool to confirm that a data point in a report traces back to a specific SEC EDGAR filing.
Example Call
# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool( "verify_fact_lineage", arguments={ "ticker": "EXAMPLE", "fact_id": "EXAMPLE"})print(result)Direct tool call:verify_fact_lineage(ticker="AAPL", fact_id="a7b3c9d2...64charsha256")
Try it now
Paste this in your terminal — the free tier returns real S&P500 data without authentication.
# No auth required — sample tier covers S&P500 with a 5-year window.# Add an Authorization: Bearer header for full universe and history.$ curl -X POST https://mcp.valuein.biz/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "verify_fact_lineage", "arguments": { "ticker": "AAPL", "fact_id": "AAPL" } } }'Inputs
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker | string | required | Stock ticker symbol, e.g. AAPL, MSFT, BRK.B |
fact_id | string | required | The deterministic fact identity hash: SHA-256(entity_id|accession_id|concept|period_end|unit). 64-character lowercase hex string. |
Output Fields
tickercikconceptvalueunitperiod_endaccession_idfiling_dateform_typesource_urlaccepted_atExample Response
{ "ticker": "AAPL", "cik": "0000320193", "concept": null, "value": 394328000000, "unit": null, "period_end": "2024-03-15", "accession_id": "0000320193-24-000006", "filing_date": "2024-03-15"}Shape only — field names match the live schema; values are placeholders, not real filings. Returns the entity, concept, value, filing accession, and source EDGAR URL for the fact identified by the hash.
Notes
fact_id is SHA-256(entity_id|accession_id|concept|period_end|unit). Enables auditors and agents to trace any number in a report back to its source filing.