findata-mcp

FinData MCP


Real-time financial data for AI agents. Stock quotes, company fundamentals, 800,000+ FRED economic indicators, SEC filings, and crypto prices. Pay-per-call ($0.01) via x402 micropayments on Base — no signup or API keys needed.

<!-- mcp-name: io.github.sapph1re/findata-mcp -->

Financial data for AI agents. Five tools — stocks, fundamentals, economics, SEC filings, crypto — accessible from any MCP client. Pay $0.01 per call, no signup.

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

| Tool | What it returns | Cache | |------|----------------|-------| | stock_quote(ticker) | Price, volume, change %, market cap | 1 min | | company_fundamentals(ticker) | Revenue, P/E, sector, beta, dividend yield, description | 1 hr | | economic_indicator(series_id) | 800,000+ FRED series (GDP, CPI, rates, yield curves) | 6 hr | | sec_filing(ticker, form_type) | Full text of 10-K, 10-Q, 8-K from SEC EDGAR | 24 hr | | crypto_price(coin_id) | Price, market cap, 24h volume, 7-day sparkline | 1 min |

---

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

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | EVM_PRIVATE_KEY | Yes | — | Wallet private key with USDC on Base | | FINDATA_BACKEND_URL | No | Production URL | Override for self-hosted backend |

---

Alternative Install Methods

uvx (no install needed):

uvx findata-mcp

---

Distribution Status

• PyPI: findata-mcp
• Glama: live
• mcp.so: live
• Official MCP Registry: pending review

• PyPI: live

License

MIT