MCP server
Finnhub MCP Server
Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and news via…
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.2.0
- Listing updated
- 4 days ago
About Finnhub MCP Server
Finnhub MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and news via Finnhub.
Install
Run in a terminal
claude mcp add finnhub-mcp-server --env FINNHUB_API_KEY='<FINNHUB_API_KEY>' -- npx -y @cyanheads/finnhub-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"finnhub-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/finnhub-mcp-server"
],
"env": {
"FINNHUB_API_KEY": "<FINNHUB_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"finnhub-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/finnhub-mcp-server"
],
"env": {
"FINNHUB_API_KEY": "<FINNHUB_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"finnhub-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/finnhub-mcp-server"
],
"env": {
"FINNHUB_API_KEY": "<FINNHUB_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"finnhub-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/finnhub-mcp-server"
],
"env": {
"FINNHUB_API_KEY": "<FINNHUB_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"finnhub-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/finnhub-mcp-server"
],
"env": {
"FINNHUB_API_KEY": "<FINNHUB_API_KEY>"
}
}
}
}Configuration
FINNHUB_API_KEYRequired. Free Finnhub API key from https://finnhub.io/register (Dashboard → API key). Free tier: 60 req/min, US real-time.RequiredFINNHUB_BASE_URLOverride the Finnhub REST API base URL (local testing / proxy).MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').MCP_TRANSPORT_TYPESelects the HTTP transport.FINNHUB_API_KEYRequired. Free Finnhub API key from https://finnhub.io/register (Dashboard → API key). Free tier: 60 req/min, US real-time.RequiredFINNHUB_BASE_URLOverride the Finnhub REST API base URL (local testing / proxy).MCP_HTTP_HOSTThe hostname for the HTTP server.MCP_HTTP_PORTThe port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Pricing
Open source
Finnhub MCP Server FAQ
Is Finnhub MCP Server free?
Yes. Finnhub MCP Server is open source, so you can use and self-host it for free.
How do I add Finnhub MCP Server to Claude Code?
Run this command in your terminal: claude mcp add finnhub-mcp-server --env FINNHUB_API_KEY='<FINNHUB_API_KEY>' -- npx -y @cyanheads/finnhub-mcp-server