mcp-finnhub

# Finnhub MCP Server An MCP server to interface with Finnhub API. ### Tools - `list_news` - List latest market news from Finnhub [market news endpoint](https://finnhub.io/docs/api/market-news) - `get_market_data` - Get market data for a particular stock from [quote endpoint](https://finnhub.io/docs/api/quote) - `get_basic_financials` - Get basic financials for a particular stock from [basic financials endpoint](https://finnhub.io/docs/api/company-basic-financials) - `get_recommendation_trends` - Get recommendation trends for a particular stock from [recommendation trend endpoint](https://finnhub.io/docs/api/company-basic-financials) ## Configuration 1. Run `uv sync` to install the dependencies. To install `uv` follow the instructions [here](https://docs.astral.sh/uv/). Then do `source .venv/bin/activate`. 2. Setup the `.env` file with the Finnhub API Key credentials. ``` FINNUB_API_KEY=<FINNHUB_API_KEY> ``` 3. Run `fastmcp install server.py` to install the server. 4. Open the configuration file located at: - On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - On Windows: `%APPDATA%/Claude/claude_desktop_config.json` 5. 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. 6. 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.