FinData MCP

io.github.sapph1rePublished by GitHub account sapph1rev0.3.3Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server giving assistants stock quotes, company fundamentals, FRED economic series, SEC filings and crypto prices, paid per call in USDC.

What you can do
Look up real-time stock prices, volume, change and market cap for NYSE/NASDAQ tickers, with short caching per tool type (1 minute to 24 hours). Retrieve company fundamentals such as revenue, P/E ratio, sector, beta and dividend yield. Read FRED macroeconomic series like GDP, CPI, unemployment and Treasury yields by series ID. Fetch the full text of SEC EDGAR filings (10-K, 10-Q, 8-K) by ticker or CIK. Check cryptocurrency prices, market cap, 24-hour volume and a 7-day sparkline by coin ID.
When to use it
Useful when an assistant needs financial or macroeconomic data for research, market commentary, company comparisons or filing review, and you are comfortable paying a small per-call fee from a crypto wallet instead of signing up for data APIs.
Requirements
Runs locally as a Python package (pip install findata-mcp or uvx) over stdio, desktop clients only. Requires the EVM_PRIVATE_KEY environment variable holding an EVM wallet private key with a small USDC balance on Base mainnet. Optional FINDATA_BACKEND_URL overrides the hosted backend. Network access to the backend and its data providers is needed.
Before you install
The server asks for a full EVM wallet private key in EVM_PRIVATE_KEY, which controls the wallet's funds; use a dedicated low-balance wallet rather than a main one. Every tool call costs $0.01 in USDC signed automatically on Base mainnet, so spending accrues without per-call confirmation. Tool calls are proxied to a hosted third-party backend, which sees your queries; data is sourced from Yahoo Finance, FRED, SEC EDGAR and CoinGecko.

Installation

In SourceWeft

  1. Open FinData MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

FinData MCP

[MCP.Directory]

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.

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

ToolWhat it returnsCache
stock_quote(ticker)Price, volume, change %, market cap1 min
company_fundamentals(ticker)Revenue, P/E, sector, beta, dividend yield, description1 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 EDGAR24 hr
crypto_price(coin_id)Price, market cap, 24h volume, 7-day sparkline1 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 — 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

VariableRequiredDefaultDescription
EVM_PRIVATE_KEYYes—Wallet private key with USDC on Base
FINDATA_BACKEND_URLNoProduction URLOverride for self-hosted backend

Alternative Install Methods

uvx (no install needed):

bash
uvx findata-mcp

Distribution Status

License

MIT

Source: README.md at commit 00bf88f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts