Finnhub MCP Server
An MCP server to interface with Finnhub API.
Tools
-
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
Configuration
-
Run
uv syncto install the dependencies. To installuvfollow the instructions here. Then dosource .venv/bin/activate. -
Setup the
.envfile with the Finnhub API Key credentials.
FINNUB_API_KEY=<FINNHUB_API_KEY>
-
Run
fastmcp install server.pyto 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
- On macOS:
-
Locate the command entry for
uvand replace it with the absolute path to theuvexecutable. This ensures that the correct version ofuvis used when starting the server. -
Restart Claude Desktop to apply the changes.
Development
Run fastmcp dev server.py to start the MCP server. MCP inspector is helpful for investigating and debugging locally.