How do I install Findata?

Findata is a local plugin. Install it using PyPI package: findata-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Findata safe to use?

Yes. Findata passed MCP Marketplace's automated security scan with a score of 9/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Findata need?

Findata requires the following credentials or environment variables: EVM_PRIVATE_KEY, FINDATA_BACKEND_URL. You can find setup instructions on the server detail page.

What AI apps work with Findata?

Findata uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Findata MCP Server

by sapph1re

Developer ToolsLow Risk9.0Local

Free

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

About

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

Security Report

9.0

Low Risk9.0Low Risk

Valid MCP server (3 strong, 3 medium validity signals). 2 known CVEs in dependencies Package registry verified. Imported from the Official MCP Registry.

6 files analyzed · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

EVM wallet private key (hex, with or without 0x prefix). Any EVM wallet with USDC on Base mainnet. Used for x402 micropayments ($0.01/call).Required

Environment variable: EVM_PRIVATE_KEY

Override the default backend URL. Defaults to https://findata-mcp-production-1cd3.up.railway.appOptional

Environment variable: FINDATA_BACKEND_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-sapph1re-findata-mcp": {
      "env": {
        "EVM_PRIVATE_KEY": "your-evm-private-key-here",
        "FINDATA_BACKEND_URL": "your-findata-backend-url-here"
      },
      "args": [
        "findata-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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.

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:

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, 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.

Read an SEC filing

sec_filing(ticker="AAPL", form_type="10-K")

{
  "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:

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