Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Finnhub MCP Server show me the upcoming earnings calendar for NVDA for next week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server wrapping the Finnhub API for financial market data.
Earnings Calendar: Get upcoming and historical earnings announcements with EPS estimates, actuals, and revenue data
API Key Authentication: Simple API key-based authentication via CLI or environment variables
Type-safe: Full TypeScript support with Zod validation
Bun-native: Optimized for Bun runtime
Related MCP server: market-data-mcp
Run directly from GitHub without cloning or installing:
npx github:ach968/finnhub-mcp --api-key YOUR_FINNHUB_API_KEY# Clone the repository
git clone https://github.com/ach968/finnhub-mcp.git
cd finnhub-mcp
# Install dependencies
bun install
# Run in development mode
bun run dev -- --api-key YOUR_FINNHUB_API_KEYAdd to your OpenCode config (~/.config/opencode/opencode.json):
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"finnhub": {
"type": "local",
"command": [
"npx",
"github:ach968/finnhub-mcp",
"--api-key",
"YOUR_FINNHUB_API_KEY"
],
"enabled": true
}
}
}{
"mcp": {
"finnhub": {
"type": "local",
"command": [
"npx",
"github:ach968/finnhub-mcp"
],
"environment": {
"FINNHUB_API_KEY": "YOUR_API_KEY"
},
"enabled": true
}
}
}finnhub.calendar.earningsGet earnings calendar for a date range.
Parameters:
from (optional): Start date in YYYY-MM-DD format (defaults to today)
to (optional): End date in YYYY-MM-DD format (defaults to 7 days from start)
symbol (optional): Filter by stock symbol (e.g., "AAPL")
Example Response:
{
"data": [
{
"date": "2024-01-25",
"symbol": "AAPL",
"quarter": "Q1",
"fiscalYear": 2024,
"time": "amc",
"eps": {
"estimate": 2.11,
"actual": 2.18,
"surprise": 0.07,
"surprisePercent": 3.32
},
"revenue": {
"estimate": 117900000000,
"actual": 119580000000,
"surprise": 1680000000,
"surprisePercent": 1.42
}
}
],
"count": 1,
"dateRange": {
"from": "2024-01-25",
"to": "2024-01-25"
}
}Time Values:
bmo: Before Market Open
amc: After Market Close
dmh: During Market Hours
Argument | Environment Variable | Description |
|
| Finnhub API key (required) |
CLI arguments take priority over environment variables.
# Development with hot reload
bun run dev
# Build for production
bun run build
# Type checking
bun run typecheck
# Run the built version
bun run start -- --api-key YOUR_KEYsrc/
├── index.ts # Main MCP server entry point
├── finnhub-client.ts # Finnhub API client
└── types.ts # TypeScript types and Zod schemasGet your free API key from Finnhub.
MIT
This project uses the Finnhub API but is not affiliated with, endorsed by, or connected to Finnhub in any way. Use this software at your own risk.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Alpha Vantage MCP — Stock market data, fundamentals, and earnings
MCP server exposing the Backtest360 engine API as tools for AI agents.
Financial Modeling Prep MCP (/stable API; v3 deprecated 2025-08-31).
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ach968/finnhub-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server