FinData MCP

FinData MCP

Stock market data, company fundamentals, FRED macroeconomic indicators, SEC EDGAR filings, and cryptocurrency prices for AI agents — all in one MCP server. Free trial: 50 calls/day. Pay-per-use: $0.01/call via x402 micropayments on Base. No signup, no API key.

Financial data for AI agents. Five tools covering real-time stock prices (NYSE, NASDAQ, 50,000+ tickers), equity fundamentals (P/E ratio, earnings, market cap), 800,000+ FRED economic series (GDP, CPI, inflation, interest rates, Treasury yields), SEC EDGAR filings (10-K annual reports, 10-Q, 8-K), and crypto prices (Bitcoin, Ethereum, 8,000+ coins). Works with Claude Desktop, Cursor, Windsurf, and any MCP client.

Quick Start

Install:

pip install findata-mcp

Set your wallet key (any EVM wallet with USDC on Base):

export EVM_PRIVATE_KEY=your_private_key_here

Add to Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{

"mcpServers": { "findata-mcp": { "command": "findata-mcp", "env": { "EVM_PRIVATE_KEY": "your_private_key_here" } } } }

Add to Cursor — edit .cursor/mcp.json in your project root:

{

"mcpServers": { "findata-mcp": { "command": "findata-mcp", "env": { "EVM_PRIVATE_KEY": "your_private_key_here" } } } }

Restart your client. You now have five financial data tools available.

Tools

Examples

Get a stock quote

stock_quote(ticker="NVDA")

{

"ticker": "NVDA", "price": 878.35, "change": 12.40, "change_pct": 1.43, "volume": 41200000, "market_cap": 2150000000000, "currency": "USD" }

Look up company fundamentals

company_fundamentals(ticker="AAPL")

{

"ticker": "AAPL", "name": "Apple Inc.", "sector": "Technology", "market_cap": 3280000000000, "pe_ratio": 33.2, "revenue": 383285000000, "beta": 1.24, "dividend_yield": 0.0044 }

Check an economic indicator

economic_indicator(series_id="FEDFUNDS")

{

"series_id": "FEDFUNDS", "title": "Federal Funds Effective Rate", "units": "Percent", "frequency": "Monthly", "latest_value": 4.33, "latest_date": "2026-02-01" }

Common FRED series: GDP, CPIAUCSL (inflation), UNRATE (unemployment), DGS10 (10-year Treasury), FEDFUNDS.

Read an SEC filing

sec_filing(ticker="AAPL", form_type="10-K")

{

"ticker_or_cik": "AAPL", "form_type": "10-K", "filing_date": "2025-11-01", "document_url": "https://www.sec.gov/Archives/...", "content": "UNITED STATES SECURITIES AND EXCHANGE COMMISSION..." }

Also accepts ticker_or_cik (legacy) or symbol as aliases for ticker.

Pricing

$0.01 per call. No signup, no API keys, no monthly fees.

Payment happens automatically via x402 — an open micropayment protocol. Your MCP client signs a USDC transfer on Base mainnet for each call. You need:

1. An EVM wallet private key (set as EVM_PRIVATE_KEY)
2. A small USDC balance on Base mainnet (~$1 covers 100 calls)

That's it. No accounts, no rate limits, no billing pages.

How It Works

The pip install package is a thin MCP stdio server. It proxies your tool calls to a hosted backend, automatically handling x402 payment signing. Data comes from Yahoo Finance, FRED, SEC EDGAR, and CoinGecko.

Your AI agent  →  findata-mcp (local stdio)  →  Backend (Railway)  →  Data providers

signs x402 payment verifies payment

Configuration

Alternative Install Methods

uvx (no install needed):

uvx findata-mcp

Distribution Status

• PyPI: findata-mcp
• Smithery: live
• Glama: live
• mcp.so: live

License

MIT