{
  "markdown": "# FinData MCP\n\n[![MCP.Directory](https://img.shields.io/badge/MCP.Directory-listed-blue)](https://mcp.directory/servers?q=findata-mcp)\n\n> 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.\n\n<!-- mcp-name: io.github.sapph1re/findata-mcp -->\n\nFinancial 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.\n\n## Quick Start\n\n**Install:**\n\n```bash\npip install findata-mcp\n```\n\n**Set your wallet key** (any EVM wallet with USDC on Base):\n\n```bash\nexport EVM_PRIVATE_KEY=your_private_key_here\n```\n\n**Add to Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"findata-mcp\": {\n      \"command\": \"findata-mcp\",\n      \"env\": {\n        \"EVM_PRIVATE_KEY\": \"your_private_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Add to Cursor** — edit `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"findata-mcp\": {\n      \"command\": \"findata-mcp\",\n      \"env\": {\n        \"EVM_PRIVATE_KEY\": \"your_private_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart your client. You now have five financial data tools available.\n\n---\n\n## Tools\n\n| Tool | What it returns | Cache |\n|------|----------------|-------|\n| `stock_quote(ticker)` | Price, volume, change %, market cap | 1 min |\n| `company_fundamentals(ticker)` | Revenue, P/E, sector, beta, dividend yield, description | 1 hr |\n| `economic_indicator(series_id)` | 800,000+ FRED series (GDP, CPI, rates, yield curves) | 6 hr |\n| `sec_filing(ticker, form_type)` | Full text of 10-K, 10-Q, 8-K from SEC EDGAR | 24 hr |\n| `crypto_price(coin_id)` | Price, market cap, 24h volume, 7-day sparkline | 1 min |\n\n---\n\n## Examples\n\n### Get a stock quote\n\n```\nstock_quote(ticker=\"NVDA\")\n```\n\n```json\n{\n  \"ticker\": \"NVDA\",\n  \"price\": 878.35,\n  \"change\": 12.40,\n  \"change_pct\": 1.43,\n  \"volume\": 41200000,\n  \"market_cap\": 2150000000000,\n  \"currency\": \"USD\"\n}\n```\n\n### Look up company fundamentals\n\n```\ncompany_fundamentals(ticker=\"AAPL\")\n```\n\n```json\n{\n  \"ticker\": \"AAPL\",\n  \"name\": \"Apple Inc.\",\n  \"sector\": \"Technology\",\n  \"market_cap\": 3280000000000,\n  \"pe_ratio\": 33.2,\n  \"revenue\": 383285000000,\n  \"beta\": 1.24,\n  \"dividend_yield\": 0.0044\n}\n```\n\n### Check an economic indicator\n\n```\neconomic_indicator(series_id=\"FEDFUNDS\")\n```\n\n```json\n{\n  \"series_id\": \"FEDFUNDS\",\n  \"title\": \"Federal Funds Effective Rate\",\n  \"units\": \"Percent\",\n  \"frequency\": \"Monthly\",\n  \"latest_value\": 4.33,\n  \"latest_date\": \"2026-02-01\"\n}\n```\n\nCommon FRED series: `GDP`, `CPIAUCSL` (inflation), `UNRATE` (unemployment), `DGS10` (10-year Treasury), `FEDFUNDS`.\n\n### Read an SEC filing\n\n```\nsec_filing(ticker=\"AAPL\", form_type=\"10-K\")\n```\n\n```json\n{\n  \"ticker_or_cik\": \"AAPL\",\n  \"form_type\": \"10-K\",\n  \"filing_date\": \"2025-11-01\",\n  \"document_url\": \"https://www.sec.gov/Archives/...\",\n  \"content\": \"UNITED STATES SECURITIES AND EXCHANGE COMMISSION...\"\n}\n```\n\nAlso accepts `ticker_or_cik` (legacy) or `symbol` as aliases for `ticker`.\n\n---\n\n## Pricing\n\n**$0.01 per call.** No signup, no API keys, no monthly fees.\n\nPayment 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:\n\n1. An EVM wallet private key (set as `EVM_PRIVATE_KEY`)\n2. A small USDC balance on Base mainnet (~$1 covers 100 calls)\n\nThat's it. No accounts, no rate limits, no billing pages.\n\n---\n\n## How It Works\n\nThe `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.\n\n```\nYour AI agent  →  findata-mcp (local stdio)  →  Backend (Railway)  →  Data providers\n                  signs x402 payment              verifies payment\n```\n\n---\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `EVM_PRIVATE_KEY` | Yes | — | Wallet private key with USDC on Base |\n| `FINDATA_BACKEND_URL` | No | Production URL | Override for self-hosted backend |\n\n---\n\n## Alternative Install Methods\n\n**uvx** (no install needed):\n\n```bash\nuvx findata-mcp\n```\n\n---\n\n## Distribution Status\n\n- PyPI: [findata-mcp](https://pypi.org/project/findata-mcp/)\n- Smithery: [live](https://smithery.ai/servers/dev-romanv/findata-mcp)\n- Glama: [live](https://glama.ai/mcp/servers/sapph1re/findata-mcp)\n- mcp.so: [live](https://mcp.so/server/findata-mcp/sapph1re)\n\n## License\n\nMIT\n",
  "bytes": 4969,
  "sha": "659150d70ebccc21ce8cb6f9bf32bf7cae5b0d7f391dbce5173c37556c1ae4f0",
  "repo_slug": "sapph1re/findata-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sapph1re_findata_mcp_93eed68b/readme"
}