Click on "Deploy 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 deployed
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
MCP server for stocksense-ai documentation, generated by doc2mcp.
Finnhub MCP — wraps Finnhub Stock API (finnhub.io)
Unlock the power of real-time financial data with our Finance MCP. Easily retrieve the latest
