Finnhub MCP Server
# 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.