Analysis
PIT-safe
Verify Fact Lineage
verify_fact_lineageSample and above
Use this tool when the user asks BOTH what a financial figure is AND which filing reported it — e.g. \
Example Call
example_call.pypython
# 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
No token required
Paste this in your terminal — the free tier returns real S&P500 data without authentication.
try-it.shbash
# No auth required — the Sample tier covers S&P 500 constituents with a 5-year window.# Add -H "Authorization: Bearer $VALUEIN_TOKEN" for the full universe and history.curl -X POST https://mcp.valuein.biz/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -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
fact_identity_idconceptstandard_concepttickercompany_nameaccession_idnumeric_valuedisplayderived_quarterly_valuederived_quarterly_displayunitperiod_startperiod_endperiod_span_daysperiod_typeform_typefiling_dateaccepted_atsource_urlinline_viewer_urldocument_urlExample Response
Illustrative
response.jsonjson
{ "fact_id": null, "entity_id": "0000320193", "concept": null, "standard_concept": null, "ticker": "AAPL", "company_name": "Apple Inc.", "accession_id": "0000320193-24-000006", "numeric_value": 394328000000}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.
Plan Access
Sample (guest)
AvailableBenchmark (token)
AvailablePro
AvailableInstitutional
Available