# Datavidence Financials

> Datavidence Financials is a freemium MCP server for finance and payments. Normalized US-GAAP financial statements for SEC filers, with as-of and revision data. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API, CLI
- **Website:** https://financials.datavidence.ai
- **Repository:** https://github.com/datavidence/datavidence-financials-mcp
- **MCP Registry name:** ai.datavidence/datavidence-financials
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-16

## About

Datavidence turns the inconsistent XBRL tags in SEC EDGAR filings into one consistent income statement, balance sheet and cash flow, so an agent can request a company's figures instead of parsing filings or recalling numbers. Passing an as-of date returns figures as originally reported at that time, which avoids look-ahead bias from later restatements, and a provenance option attaches the SEC accession number, filing date, EDGAR URL and us-gaap tag to each value.

Six tools cover single and batch statement lookups (up to 25 companies), recent filings, restatement history, company search by name for ticker and CIK, and a free usage check. Coverage is every SEC XBRL filer from about 2009. The README is clear about scope: US-GAAP only, with IFRS filers returning an unsupported signal rather than wrong numbers.

The connector is MIT licensed and runs over stdio with uvx or pipx, while the underlying API is a commercial service. A sandbox key returns sample data with no sign-up, a remote URL is available, and live data uses a RapidAPI key. The Free plan allows 1,500 requests a month and paid plans start at $29.

## Features

- **Normalized statements:** Maps filer-specific XBRL tags to one US-GAAP schema.
- **Point-in-time data:** Returns figures as originally reported on a chosen date.
- **Provenance links:** Cites the SEC filing, EDGAR URL and tag for each value.
- **Batch lookup:** Fetches up to 25 companies in one call.
- **Revision tracking:** Shows how a year's figures changed across filings.
- **Sandbox key:** Lets you try sample data without signing up.

## Good for

- Ask for a company's income statement and ratios
- Backtest without restatement look-ahead bias
- Trace a reported number to its SEC filing
- Compare many companies' fundamentals in one call
- Find a company's CIK from its name

## Install

### Claude Code (Terminal)

```sh
claude mcp add datavidence-financials --env FL_API_KEY='<FL_API_KEY>' -- uvx datavidence-financials
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "datavidence-financials": {
      "command": "uvx",
      "args": [
        "datavidence-financials"
      ],
      "env": {
        "FL_API_KEY": "<FL_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "datavidence-financials": {
      "command": "uvx",
      "args": [
        "datavidence-financials"
      ],
      "env": {
        "FL_API_KEY": "<FL_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "datavidence-financials": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "datavidence-financials"
      ],
      "env": {
        "FL_API_KEY": "<FL_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "datavidence-financials": {
      "command": "uvx",
      "args": [
        "datavidence-financials"
      ],
      "env": {
        "FL_API_KEY": "<FL_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "datavidence-financials": {
      "command": "uvx",
      "args": [
        "datavidence-financials"
      ],
      "env": {
        "FL_API_KEY": "<FL_API_KEY>"
      }
    }
  }
}
```

## Tools

- `get_financials`: Normalized three statements for a company and fiscal year, with as_of, provenance and ratios.
- `get_financials_batch`: Up to 25 companies in one call.
- `list_filings`: Discovers a company's recent SEC filings.
- `get_revisions`: Shows how a year's figures changed across filings.
- `search_companies`: Finds a ticker and CIK by company name.
- `get_usage`: Shows your quota; free and consumes nothing.

## FAQ

### Can I try it without an account?

Yes. The sandbox_demo_key returns sample data with no signup; live data needs a RapidAPI key.

### What does it cost?

The Free plan includes 1,500 requests a month; paid plans start at $29 a month.

### What filers are covered?

Every SEC XBRL filer from roughly 2009 onward, US-GAAP only.

### How is it installed?

Run uvx datavidence-financials or pipx install it, or connect to the remote URL.

### Is Datavidence Financials free?

Datavidence Financials has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

### How do I add Datavidence Financials to Claude Code?

Run this command in your terminal: claude mcp add datavidence-financials --env FL_API_KEY='<FL_API_KEY>' -- uvx datavidence-financials

### What are the best alternatives to Datavidence Financials?

The closest alternatives to Datavidence Financials are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/datavidence-financials
