FinData MCP
Stocks, fundamentals, FRED economics, SEC filings & crypto. x402 micropayments, $0.01/call.
Open source Open in the app JSON README (API)
About
Stocks, fundamentals, FRED economics, SEC filings & crypto. x402 micropayments, $0.01/call.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- sapph1re
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.3.3
- Stars
- 1
- Forks
- 1
- Last push
- 2026-08-05T20:28:54Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 04:01:21
- Updated
- 2026-08-29 04:01:21
- Origin id
io.github.sapph1re/findata-mcp
README
# FinData MCP
[](https://mcp.directory/servers?q=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.
<!-- mcp-name: io.github.sapph1re/findata-mcp -->
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:**
```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
```
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
```
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
```
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
```
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](https://www.x402.org/) — 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):
```bash
uvx findata-mcp
```
---
## Distribution Status
- PyPI: [findata-mcp](https://pypi.org/project/findata-mcp/)
- Smithery: [live](https://smithery.ai/servers/dev-romanv/findata-mcp)
- Glama: [live](https://glama.ai/mcp/servers/sapph1re/findata-mcp)
- mcp.so: [live](https://mcp.so/server/findata-mcp/sapph1re)
## License
MIT