How do I use aigroup-finnhub-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@aigroup-finnhub-mcp show me the latest news sentiment for TSLA" 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.

aigroup-finnhub-mcp

by jackdark425

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

aigroup-finnhub-mcp

Node.js MCP server for Finnhub financial market data.

Overview

aigroup-finnhub-mcp provides a practical MCP wrapper around the Finnhub API for:

stock quotes and candles
company profiles and fundamentals
technical indicators and trading signals
news, sentiment, and insider sentiment
crypto market data

Related MCP server: Alpha Vantage MCP Server

Highlights

15 MCP tools grouped by market data, technical analysis, fundamentals, news, and crypto
TypeScript + Zod validation for safer input handling
Built-in rate limiting with retry logic
Structured error handling for more reliable downstream use
Designed for MCP clients such as Claude Desktop and similar tools

Quick Start

Requirements

Node.js >= 18
npm
A valid Finnhub API key

Install and build

git clone https://github.com/jackdark425/aigroup-finnhub-mcp.git
cd aigroup-finnhub-mcp
npm install
npm run build

Configure API key

FINNHUB_API_KEY=your_api_key_here npm start

You can get an API key from Finnhub Dashboard.

Configuration

If you use a local .env file:

cp .env.example .env

Then set:

FINNHUB_API_KEY=your_api_key_here

MCP Client Configuration

Using npx

{
  "mcpServers": {
    "aigroup-finnhub": {
      "command": "npx",
      "args": ["-y", "aigroup-finnhub-mcp"],
      "env": {
        "FINNHUB_API_KEY": "your_finnhub_api_key_here"
      }
    }
  }
}

Using local build output

{
  "mcpServers": {
    "aigroup-finnhub": {
      "command": "node",
      "args": ["/path/to/aigroup-finnhub-mcp/dist/index.js"],
      "env": {
        "FINNHUB_API_KEY": "your_finnhub_api_key_here"
      }
    }
  }
}

Tool Groups

Tool	Operations	Description
`finnhub_stock_market_data`	7	Quotes, candles, profiles, financials
`finnhub_technical_analysis`	4	Indicators, patterns, signals
`finnhub_news_sentiment`	4	News and sentiment workflows
`finnhub_stock_fundamentals`	5	Financial metrics, dividends, splits
`finnhub_crypto_data`	4	Crypto exchanges, symbols, prices

API Reference

`finnhub_stock_market_data`

get_quote
get_candles
get_company_profile
symbol_lookup
get_basic_financials
get_financials_as_reported
get_earnings_surprises

`finnhub_technical_analysis`

get_indicator
get_aggregate_signals
get_pattern_recognition
get_support_resistance

`finnhub_news_sentiment`

get_company_news
get_market_news
get_news_sentiment
get_insider_sentiment

Development

npm run typecheck
npm run lint
npm run test

Acknowledgments

Reference Project

cfdude/mcp-finnhub
- Repository: https://github.com/cfdude/mcp-finnhub
- Reference scope: overall project direction, MCP server structure, and interface organization

Thanks to cfdude for the prior open-source work that helped inform this implementation.

License & Usage

This project is released under the MIT License.

You may use, copy, modify, merge, publish, distribute, sublicense, and sell copies of this software, including for commercial use, as long as the original copyright notice and license text are preserved.

Please note:

the software is provided "AS IS", without warranty of any kind
you must retain the license and copyright notice in copies or substantial portions of the software
usage of the Finnhub API remains subject to Finnhub's own terms of service, rate limits, and data licensing restrictions

See the full text in LICENSE.

Support

Issues: https://github.com/jackdark425/aigroup-finnhub-mcp/issues
Repository: https://github.com/jackdark425/aigroup-finnhub-mcp

Available Tools

15 tools

finnhub_alternative_dataB

Access alternative data including ESG scores, social sentiment, and patents. Supports JSON export for large datasets.. Operations: get_esg_score, get_social_sentiment, get_supply_chain, get_patents

Inputs: operation (required), to, from, export, +2 more.

finnhub_calendar_dataC

Access IPO, earnings, economic, and FDA calendars. Supports JSON export for large datasets.. Operations: get_ipo_calendar, get_earnings_calendar, get_economic_calendar, get_fda_calendar

Inputs: operation (required), to, from, export, +2 more.

finnhub_crypto_dataB

Access cryptocurrency market data. Supports JSON export for large datasets.. Operations: get_exchanges, get_symbols, get_quote, get_candles

Inputs: operation (required), days, export, symbol, +3 more.

finnhub_forex_dataB

Access foreign exchange market data. Supports JSON export for large datasets.. Operations: get_exchanges, get_symbols, get_rate, get_candles

Inputs: operation (required), to, days, from, +5 more.

finnhub_job_statusC

Check the status of background jobs. Operations: get

Inputs: operation (required), job_id.

finnhub_market_eventsB

Access market holidays, analyst ratings, and M&A activity. Supports JSON export for large datasets.. Operations: get_market_holidays, get_analyst_ratings, get_merger_acquisitions

Inputs: operation (required), export, symbol, project, +1 more.

finnhub_news_sentimentC

Access company news, market news, and sentiment analysis. Supports JSON export for large datasets.. Operations: get_company_news, get_market_news, get_news_sentiment, get_insider_sentiment

Inputs: operation (required), to, days, from, +4 more.

finnhub_project_createC

Create a new project workspace for storing data. Operations: create

Inputs: operation (required), name.

finnhub_project_listC

List all available projects. Operations: list

Inputs: operation (required), verbose.

finnhub_sec_filingsB

Access SEC filings and filing sentiment analysis. Supports JSON export for large datasets.. Operations: get_sec_filings, get_filing_sentiment, get_similarity_index

Inputs: operation (required), to, form, from, +3 more.

finnhub_stock_estimatesB

Access analyst estimates and recommendations. Supports JSON export for large datasets.. Operations: get_earnings_estimates, get_revenue_estimates, get_ebitda_estimates, get_price_target, get_recommendation_trends

Inputs: operation (required), export, symbol, project.

finnhub_stock_fundamentalsC

Access fundamental financial data including metrics, dividends, and revenue breakdown. Supports JSON export for large datasets.. Operations: get_basic_financials, get_financials_as_reported, get_dividends, get_stock_splits, get_revenue_breakdown

Inputs: operation (required), to, freq, from, +4 more.

finnhub_stock_market_dataB

Access stock market data including real-time quotes, historical candles, company profiles, and financial data. Supports JSON export for large datasets.. Operations: get_quote, get_candles, get_company_profile, symbol_lookup, get_basic_financials, get_financials_as_reported, get_earnings_surprises

Inputs: operation (required), to, days, freq, +7 more.

finnhub_stock_ownershipC

Access insider transactions and institutional ownership data. Supports JSON export for large datasets.. Operations: get_insider_transactions, get_institutional_ownership, get_institutional_portfolio, get_congress_transactions

Inputs: operation (required), to, cik, from, +3 more.

finnhub_technical_analysisC

Technical analysis tools including 50+ indicators, pattern recognition, and support/resistance levels. Supports JSON export for large datasets.. Operations: get_indicator, get_aggregate_signals, get_pattern_recognition, get_support_resistance

Inputs: operation (required), days, export, stdDev, +8 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.2/5.0

Scored 2026-07-05 08:00 across 15 tools

Disambiguation4/5

Tools are well-separated by domain, but there is operation overlap between 'finnhub_stock_market_data' and 'finnhub_stock_fundamentals' (both include get_basic_financials, get_financials_as_reported), and between 'finnhub_market_events' and 'finnhub_stock_estimates' regarding analyst data. This could cause some agent confusion.

Naming Consistency5/5

All tools follow a consistent 'finnhub_<domain>_<subdomain>' pattern with snake_case. Operation names are uniformly verb_noun (e.g., get_quote, create_project). No mixing of conventions.

Tool Count5/5

With 15 tools covering diverse financial data domains (stocks, forex, crypto, news, SEC filings, etc.), the count is well-scoped. Each tool serves a clear purpose without being excessive or insufficient.

Completeness4/5

The tool set covers a broad range of financial data including stocks, forex, crypto, news sentiment, fundamentals, technical analysis, and calendars. Missing asset classes like options or bonds, and some operation duplication, prevent a perfect score. The project management tools add extra utility.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

FinnhubB
io.github.pipeworx-io
Finnhub MCP — wraps Finnhub Stock API (finnhub.io)
Finance Research & Data
512
https://gateway.pipeworx.io/finnhub/mcp
Financial Modeling Prep MCP ServerA
io.github.imbenrabi
MCP server for Financial Modeling Prep API with 250+ financial data tools
Finance Open Data
51149
https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp
stocksense-ai
io.github.doc2mcp
MCP server for stocksense-ai documentation, generated by doc2mcp.
Documentation Access Finance
24
https://doc2mcp.site/api/mcp/d7de7361-0a4a-4deb-b2a5-0849d5bb0a34/mcp
Marketdata AppA
io.github.pipeworx-io
Market Data App MCP — wraps the Market Data App API (marketdata.app)
Finance Cryptocurrency
481
https://gateway.pipeworx.io/marketdata-app/mcp

Related MCP Servers

AlphaVantage MCP Server
Finance Search
lifejwang11
A
license
Not graded
quality
D
maintenance
An MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.
Updated a year ago (2025-05-21 01:18 UTC)
MIT
Alpha Vantage MCP Server
Finance Cryptocurrency
deepsuthar496
A
license
A
quality
D
maintenance
An MCP server that provides real-time financial data integration with Alpha Vantage's API, enabling access to stock market data, cryptocurrency prices, forex rates, and technical indicators.
Updated a year ago (2025-07-26 03:43 UTC)
7
12 npm
4
MIT
market-data-mcp
SmashToes
-
license
Not graded
quality
Not graded
maintenance
Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
Updated 9 months ago (2026-02-15 04:09 UTC)
-
mcp-finnhub
Finance Research & Data
cfdude
A
license
B
quality
C
maintenance
MCP server providing comprehensive access to Finnhub financial market data API for AI assistants like Claude Desktop.
Updated 10 days ago (2026-11-01 19:09 UTC)
15
33 PyPI
10
MIT

aigroup-finnhub-mcp

Overview

Highlights

Quick Start

Requirements

Install and build

Configure API key

Configuration

MCP Client Configuration

Using npx

Using local build output

Tool Groups

API Reference

finnhub_stock_market_data

finnhub_technical_analysis

finnhub_news_sentiment

Development

Acknowledgments

Reference Project

License & Usage

Support

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

AlphaVantage MCP Server

Alpha Vantage MCP Server

market-data-mcp

mcp-finnhub

`finnhub_stock_market_data`

`finnhub_technical_analysis`

`finnhub_news_sentiment`