Skip to main content

FinzData MCP server

US market data inside Claude, ChatGPT, Cursor and any MCP client.

What you get

  • prices_daily — daily OHLCV for US equities
  • cot — Commitments of Traders reports
  • cot_markets — available COT market codes
  • macro — 10,000+ US economic series from FRED (inflation, jobs, rates, credit, consumer spending)
  • macro_search — search macro series by keyword
  • short_interest — short interest and days to cover
  • insiders — insider transaction filings (Form 4)
  • fundamentals — raw SEC XBRL facts by concept
  • financial_statements — income statement, balance sheet and cash flow, quarterly or annual
  • company_profile — company overview, sector, description
  • earnings_dates — past earnings release dates and before/after-market timing

Free tier

Every tool returns the last 12 months only. Older history (stocks back to 2000, every macro revision, 1-minute, 5-minute and hourly bars, 13F institutional holdings) comes with a history bundle: https://finzdata.com/pricing

Setup

  1. Get a free API key at https://api.finzdata.com/
  2. Install: pip install finzdata-mcp
  3. Add to your MCP client configuration:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "finzdata": {
      "command": "finzdata-mcp",
      "env": {
        "FINZDATA_API_KEY": "your-key"
      }
    }
  }
}

Cursor (.cursor/mcp.json): same JSON as above.

No-install alternative: uvx finzdata-mcp

Example questions

  • Chart NVDA's daily closes over the past year
  • How are hedge funds positioned in gold futures?
  • Which large caps have the highest short interest?
  • How has US credit card debt changed this year?
  • Which insiders bought or sold NVDA stock this year?

Settings

  • FINZDATA_API_KEY (required) — your FinzData API key
  • FINZDATA_MCP_MAX_ROWS (default 2000) — maximum rows returned per tool call

Data, not investment advice. FinzData — Clean data. Real insights. Real alpha. https://finzdata.com

Metadata

Release files for finzdata-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for finzdata-mcp 0.1.0
File Size Uploaded
finzdata_mcp-0.1.0.tar.gz 8.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for finzdata-mcp 0.1.0
File Interpreter ABI Platform
finzdata_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.8 kB

Release files / finzdata_mcp-0.1.0.tar.gz

Download URL finzdata_mcp-0.1.0.tar.gz
Size 8.2 kB
Tags Source
SHA-256 checksum
How to use checksums
9e2811268ff0225d444007388fd6baf614f85bc3d39798e9617403b0bd497831
BLAKE2b-256 checksum
How to use checksums
988c5fca07a5b4e412b5d10fa643283da04e878379f615a6723e3a8aa55904f9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release files / finzdata_mcp-0.1.0-py3-none-any.whl

Download URL finzdata_mcp-0.1.0-py3-none-any.whl
Size 9.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
968b4ff50bb8704a02be80ab4facc366e3e78452abb351ce430da5413f87425f
BLAKE2b-256 checksum
How to use checksums
304a7b1e3c343e8b3cafd5b87c4e2bdc20157106e38f10245f9b161de67805f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page