io.github.sapph1re/findata-mcp

Official

by sapph1re · Python

FinData MCP

Stocks, fundamentals, FRED economics, SEC filings & crypto. x402 micropayments, $0.01/call.

Access stocks, economics data, SEC filings, and crypto with micropayment pricing.

README.md5 KBView on GitHub

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.

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:

bash

pip install findata-mcp

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

bash

export EVM_PRIVATE_KEY=your_private_key_here

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

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:

json

{
  "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

code

stock_quote(ticker="NVDA")

json

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

Look up company fundamentals

code

company_fundamentals(ticker="AAPL")

json

{
  "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

code

economic_indicator(series_id="FEDFUNDS")

json

{
  "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

code

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

json

{
  "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:

An EVM wallet private key (set as EVM_PRIVATE_KEY)
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.

code

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):

bash

uvx findata-mcp

Distribution Status

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

License

MIT

Install

Configuration

Environment variables

EVM_PRIVATE_KEYrequiredsecret

EVM wallet private key (hex, with or without 0x prefix). Any EVM wallet with USDC on Base mainnet. Used for x402 micropayments ($0.01/call).

FINDATA_BACKEND_URL

Override the default backend URL. Defaults to https://findata-mcp-production-1cd3.up.railway.app

claude_desktop_config.json

{
  "mcpServers": {
    "findata-mcp": {
      "command": "uvx",
      "args": [
        "findata-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<YOUR_EVM_PRIVATE_KEY>",
        "FINDATA_BACKEND_URL": "<YOUR_FINDATA_BACKEND_URL>"
      }
    }
  }
}