datavidence/datavidence-financials-mcp

Normalized US-GAAP financial statements for every SEC XBRL filer — point-in-time, as originally reported — as MCP tools for your AI agent (or a plain REST API).
Language models are good at reasoning about financial statements and bad at getting them. SEC EDGAR has the data, but its XBRL is a thicket of inconsistent tags, renamed concepts, and per-filer quirks — so agents either hallucinate the numbers or you spend weeks building a normalization layer. This is that layer: your agent asks for a company's financials and gets a clean, consistent answer — over the Model Context Protocol, or as a plain REST API.
> ⭐ If this is useful, please star the repo. It's a solo, early project, and stars are how other developers find it.
This is the open-source, AI-native layer for the Datavidence Financials API — a standalone stdio server that forwards over HTTPS to the REST API (bring your own key). The connector is MIT-licensed; the underlying API is a commercial service.
## Try it in 30 seconds (no signup)
Run it with no clone using uv — it installs into a throwaway environment:
bash
FLAPIKEY=sandboxdemokey uvx datavidence-financials
sandboxdemokey returns sample data with no signup — good for a first run. Set FLAPIKEY to your real key for live SEC data. The server speaks MCP over stdio, so an MCP client (e.g. Claude Desktop, below) launches it.
Or install it as a persistent tool with pipx:
bash
pipx install datavidence-financials
FLAPIKEY=sandboxdemokey datavidence-financials
## Connect by URL (no install)
Clients that support remote MCP servers (streamable HTTP) can connect without installing anything:
| URL | Key | Data |
| https://mcp.financials.datavidence.ai/mcp | none | sample (AAPL FY2023) |
| https://mcp.financials.datavidence.ai/rapidapi/mcp | your RapidAPI key, as X-API-Key or Authorization: Bearer | live SEC data, metered by RapidAPI against your plan |
Claude Code:
bash
claude mcp add --transport http datavidence-financials \
https://mcp.financials.datavidence.ai/rapidapi/mcp \
--header "X-API-Key: YOURRAPIDAPIKEY"
For the sample data, use the /mcp URL and leave out the header.
claude.ai: add https://mcp.financials.datavidence.ai/mcp as a custom connector with no sign-in. claude.ai can't send an API key for most accounts yet, so it gets the sample data for now.
## Why it's different
Point-in-time, as originally reported. Pass an asof date and you get the figures as they stood then — no look-ahead bias from later restatements. The thing backtests quietly get burned without.
Normalized to one schema. EDGAR's XBRL tags drift between filers and change over the years. We map them to a single US-GAAP income statement, balance sheet, and cash flow — including the awkward cases (noncontrolling interest, mezzanine/temporary equity, non-calendar fiscal years) — so you never parse a filing.
Every SEC XBRL filer. Coverage is the whole SEC XBRL universe (~2009 to present), fetched and normalized on demand — any CIK with XBRL facts, not a curated subset.
Source-linked, too. Turn on provenance and every value carries its SEC accession, filed date, and a direct EDGAR URL — so the model cites the filing instead of inventing a number.