mcp-finnhub MCP Server

README

Finnhub MCP Server

An MCP server to interface with Finnhub API.

list_news
- List latest market news from Finnhub market news endpoint
get_market_data
- Get market data for a particular stock from quote endpoint
get_basic_financials
- Get basic financials for a particular stock from basic financials endpoint
get_recommendation_trends
- Get recommendation trends for a particular stock from recommendation trend endpoint

Run uv sync to install the dependencies. To install uv follow the instructions here. Then do source .venv/bin/activate.
Setup the .env file with the Finnhub API Key credentials.

FINNUB_API_KEY=<FINNHUB_API_KEY>

Run fastmcp install server.py to install the server.
Open the configuration file located at:
- On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%/Claude/claude_desktop_config.json
Locate the command entry for uv and replace it with the absolute path to the uv executable. This ensures that the correct version of uv is used when starting the server.
Restart Claude Desktop to apply the changes.

Run fastmcp dev server.py to start the MCP server. MCP inspector is helpful for investigating and debugging locally.

mcp-finnhub FAQ

How do I configure the mcp-finnhub server?

Set your Finnhub API key in the .env file as FINNUB_API_KEY and install dependencies using uv sync, then activate the virtual environment.

What tools does the mcp-finnhub server provide?

It offers tools to list market news, get market data, retrieve basic financials, and fetch recommendation trends for stocks.

How do I install the mcp-finnhub server?

After setting up dependencies and environment variables, run fastmcp install server.py to install the server.

Can I use mcp-finnhub with multiple LLM providers?

Yes, it is compatible with models from OpenAI, Anthropic Claude, and Google Gemini via MCP clients.

Is real-time data available through mcp-finnhub?

Yes, it provides real-time market quotes and news directly from the Finnhub API.

What programming environment is required?

The server requires Python with dependencies installed via uv and a virtual environment activated.

How secure is the API key management?

API keys are managed via environment variables in the .env file, keeping credentials secure and separate from code.

Can I extend mcp-finnhub with additional Finnhub endpoints?

Yes, the server can be extended by adding new MCP tools mapping to other Finnhub API endpoints.