Model Context Protocol server for Finnhub financial market data API
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-finnhub","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# mcp-finnhub [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://modelcontextprotocol.io) Model Context Protocol (MCP) server providing comprehensive access to [Finnhub](https://finnhub.io) financial market data API. Built for AI assistants like Claude Desktop to seamlessly access real-time market data, technical indicators, fundamentals, and alternative data. ## Features - **15 MCP Tools** covering 100+ Finnhub API endpoints - **Real-time market data**: Quotes, candles, tick data, BBO - **Technical analysis**: 50+ indicators, patterns, support/resistance - **Fundamentals**: Financials, earnings, dividends, metrics - **Alternative data**: ESG scores, social sentiment, supply chain - **Multi-asset support**: Stocks, crypto, forex, ETFs, bonds - **Project-based storage** with automatic CSV/JSON exports - **Background job processing** for large datasets - **Smart output handling** with token estimation - **Configurable tools** - enable only what you need - **AI-friendly errors** - Structured error responses with guidance - **Built-in help** - Every tool supports `operation="help"` for discovery ## Quick Start ### Prerequisites - Python 3.11 or higher - [Finnhub API key](https://finnhub.io/register) (free tier available) - [Claude Desktop](https://claude.ai/download) or compatible MCP client ### Installation #### Option 1: Install from PyPI (coming soon) ```bash pip install mcp-finnhub ``` #### Option 2: Install from source ```bash git clone https://github.com/cfdude/mcp-finnhub.git cd mcp-finnhub pip install -e . ``` ### Configuration 1. Create a `.env` file in your project root: ```bash # Required FINNHUB_API_KEY=your_api_key_here FINNHUB_STORAGE_DIR=/path/to/storage # Optional - Tool configuration FINNHUB_ENABLE_TECHNI…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.