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
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| findata_mcp-0.3.5.tar.gz | 6.7 kB | Without provenance | Details for findata_mcp-0.3.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| findata_mcp-0.3.5-py3-none-any.whl | Python 3 | none | any | Details for findata_mcp-0.3.5-py3-none-any.whl |
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
|
Security for findata-mcp 0.3.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.