Finnhub MCP Server

What is Finnhub MCP Server?

Finnhub MCP Server is an MCP (Model Context Protocol) server that provides access to Finnhub's financial data API. It enables AI agents to retrieve market news, stock quotes, basic financials, and recommendation trends.

How to use Finnhub MCP Server?

Install dependencies with uv sync, create a .env file with your FINNHUB_API_KEY, and run fastmcp install server.py to install the server. Then update the Claude Desktop configuration file with the absolute path to uv and restart Claude Desktop. For development, run fastmcp dev server.py.

Key features of Finnhub MCP Server

• list_news – fetch latest market news
• get_market_data – get real-time stock quotes
• get_basic_financials – retrieve company fundamentals
• get_recommendation_trends – view analyst recommendations
• Easy setup with uv and fastmcp
• Integrates directly with Claude Desktop

Use cases of Finnhub MCP Server

• Asking an AI assistant for the latest market news
• Checking real-time stock prices during a conversation
• Analyzing a company's financial health through basic metrics
• Understanding analyst sentiment on a stock

FAQ from Finnhub MCP Server

What is the Finnhub MCP Server?

It is an MCP server that acts as a bridge between AI agents (like Claude) and the Finnhub financial data API.

How do I install the Finnhub MCP Server?

Run uv sync to install dependencies, set up a .env file with FINNHUB_API_KEY=<your_key>, then run fastmcp install server.py.

What dependencies are required?

You need Python, the uv package manager, and the fastmcp toolchain.

How do I configure the Finnhub API key?

Create a .env file in the project root with the line FINNHUB_API_KEY=<your_finnhub_api_key>.

How do I run the server in development mode?

Use the command fastmcp dev server.py to start the MCP server with the inspector.