Finnhub MCP Server

By catherinedparnell GitHub

An MCP server to interface with Finnhub API.

mcp-finnhub api

Overview

what is Finnhub MCP Server?

Finnhub MCP Server is a server designed to interface with the Finnhub API, providing access to various financial data and market news.

how to use Finnhub MCP Server?

To use the Finnhub MCP Server, you need to install the necessary dependencies, set up your Finnhub API key, and run the server using the provided commands.

key features of Finnhub MCP Server?

List latest market news from Finnhub.
Retrieve market data for specific stocks.
Access basic financials for companies.
Get recommendation trends for stocks.

use cases of Finnhub MCP Server?

Monitoring real-time market news and updates.
Analyzing stock performance through market data.
Evaluating company financials for investment decisions.
Understanding market sentiment through recommendation trends.

FAQ from Finnhub MCP Server?

What is required to run the Finnhub MCP Server?

You need to install dependencies, set up an API key, and configure the server.

Can I use this server for any stock?

Yes! The server can retrieve data for any stock available in the Finnhub API.

Is there any cost associated with using the Finnhub API?

The Finnhub API has both free and paid tiers depending on the usage.

Content

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 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.