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:
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_or_cik, 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.
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.
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
Release files for findata-mcp 0.3.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| findata_mcp-0.3.5.tar.gz | 6.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| findata_mcp-0.3.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 14.9 kB
Release files / findata_mcp-0.3.5.tar.gz
| Download URL | findata_mcp-0.3.5.tar.gz |
|---|---|
| Size | 6.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4f70f7d78762687934b8585412d314937cd42f7b1c1fb2f0977a2a269fb30f75
|
|
BLAKE2b-256 checksum How to use checksums |
59138137c87ff6edc9615d3118aa6590261c32e531601e820ea52709b0ea3e34
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / findata_mcp-0.3.5-py3-none-any.whl
| Download URL | findata_mcp-0.3.5-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
30910ca606d987516ea3d6213ebfd370e186a8bbc51e52a3b81e58379afd8a90
|
|
BLAKE2b-256 checksum How to use checksums |
d325d33b803d3830e815c31029629059611f6864a081e5f72ff5467739292733
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|