Skip to main content
Glama
cfdude

mcp-finnhub

by cfdude
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FINNHUB_API_KEYYesYour Finnhub API key (required).
FINNHUB_STORAGE_DIRYesPath to the storage directory for project data (required).
FINNHUB_RATE_LIMIT_RPMNoRequests per minute limit (optional).300
FINNHUB_REQUEST_TIMEOUTNoRequest timeout in seconds (optional).30
FINNHUB_SAFE_TOKEN_LIMITNoConservative token limit (optional).75000
FINNHUB_ENABLE_NEWS_SENTIMENTNoEnable news sentiment tools (optional).true
FINNHUB_ENABLE_STOCK_MARKET_DATANoEnable stock market data tools (optional).true
FINNHUB_ENABLE_TECHNICAL_ANALYSISNoEnable technical analysis tools (optional).true

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
finnhub_stock_market_dataC

Real-time quotes, historical candles, and company profiles.

Operations:

  • get_quote: Get real-time quote for a symbol

  • get_company_profile: Get company profile and details

  • get_market_status: Get market open/close status

  • search_symbols: Search for symbols by name

  • get_candles: Get historical OHLCV candles

  • get_symbols: List symbols for an exchange

  • get_financials: Get financial statements

  • get_earnings: Get earnings data

finnhub_news_sentimentC

Company news, market news, and sentiment analysis.

Operations:

  • get_company_news: Get news for a specific company

  • get_market_news: Get general market news

  • get_news_sentiment: Get sentiment analysis for news

  • get_insider_sentiment: Get insider sentiment data

finnhub_technical_analysisC

Technical indicators, patterns, and signals.

Operations:

  • scan_patterns: Scan for technical chart patterns

  • support_resistance: Get support and resistance levels

  • aggregate_signals: Get aggregated technical signals

  • get_indicator: Calculate specific technical indicator

finnhub_stock_fundamentalsA

Financial statements, earnings, dividends, and splits.

Operations:

  • get_basic_financials: Get key financial metrics

  • get_reported_financials: Get reported financial statements

  • get_sec_financials: Get SEC-reported financials

  • get_dividends: Get dividend history

  • get_splits: Get stock split history

  • get_revenue_breakdown: Get revenue by segment/geography

For get_basic_financials:

  • include_series: Include historical time series (default: False, saves ~100K+ tokens)

  • series_limit: Max periods per metric when include_series=True (e.g., 4 = last 4 periods)

finnhub_stock_estimatesA

Analyst estimates for earnings, revenue, EBITDA, and price targets.

Operations:

  • get_earnings_estimates: Get analyst earnings estimates

  • get_revenue_estimates: Get analyst revenue estimates

  • get_ebitda_estimates: Get analyst EBITDA estimates

  • get_price_targets: Get analyst price targets (Premium)

  • get_recommendations: Get analyst recommendations

finnhub_stock_ownershipB

Insider trades, institutional ownership, and congressional trading.

Operations:

  • get_insider_transactions: Get insider trading activity

  • get_institutional_ownership: Get institutional holders

  • get_institutional_portfolio: Get institution's portfolio by CIK

  • get_congressional_trades: Get congressional trading activity

finnhub_alternative_dataC

ESG scores, social sentiment, supply chain, and patents.

Operations:

  • get_esg_scores: Get ESG (Environmental, Social, Governance) scores

  • get_social_sentiment: Get social media sentiment

  • get_supply_chain: Get supply chain relationships

  • get_patents: Get patent filings

finnhub_sec_filingsC

SEC filings, filing sentiment, and similarity analysis.

Operations:

  • get_sec_filings: Get SEC filing history

  • get_filing_sentiment: Get sentiment analysis of a filing

  • get_similarity_index: Get filing similarity index

finnhub_crypto_dataC

Cryptocurrency exchanges, symbols, profiles, and candles.

Operations:

  • get_crypto_exchanges: List crypto exchanges

  • get_crypto_symbols: List symbols for an exchange

  • get_crypto_profile: Get crypto profile (e.g., BTC)

  • get_crypto_candles: Get historical OHLCV candles

finnhub_forex_dataB

Foreign exchange rates, symbols, and candles.

Operations:

  • get_forex_exchanges: List forex exchanges

  • get_forex_symbols: List symbols for an exchange

  • get_forex_rates: Get exchange rates for base currency

  • get_forex_candles: Get historical OHLCV candles

finnhub_calendar_dataB

IPO calendar, earnings calendar, economic events, and FDA meetings.

Operations:

  • get_ipo_calendar: Get upcoming IPOs

  • get_earnings_calendar: Get earnings announcements

  • get_economic_calendar: Get economic events

  • get_fda_calendar: Get FDA advisory committee meetings

finnhub_market_eventsC

Market holidays, analyst upgrades/downgrades, and M&A activity.

Operations:

  • get_market_holidays: Get market holiday schedule

  • get_upgrade_downgrade: Get analyst rating changes

  • get_merger_acquisition: Get M&A activity

finnhub_project_createB

Create project workspaces for organizing data.

Operations:

  • create: Create a new project workspace

finnhub_project_listA

List all project workspaces with statistics.

Operations:

  • list: List all projects

finnhub_job_statusC

Check status of background jobs.

Operations:

  • get_status: Get status of a specific job

  • list_jobs: List all jobs

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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 across 15 tools

Disambiguation3/5

The tool categories are mostly distinct, but overlap exists between finnhub_stock_market_data's get_financials/get_earnings and finnhub_stock_fundamentals or finnhub_stock_estimates, as well as between market_events analyst upgrades and estimates recommendations. This creates ambiguity for an agent selecting the appropriate tool.

Naming Consistency5/5

All 15 tools follow the consistent pattern 'finnhub_<domain>' using snake_case, such as finnhub_stock_estimates, finnhub_crypto_data, and finnhub_job_status. The naming is uniform and predictable.

Tool Count4/5

15 tools is at the upper bound of the ideal range but suits the broad scope of financial data covered (stocks, crypto, forex, news, fundamentals, estimates, etc.). Some tools like finnhub_project_create and finnhub_project_list are ancillary, but the count is reasonable.

Completeness4/5

The tool set provides comprehensive coverage of financial data: real-time quotes, candles, fundamentals, estimates, news, technical analysis, insider trading, crypto, forex, and calendars. Minor gaps include missing project delete/update operations and some redundant data retrieval paths (e.g., get_financials vs get_basic_financials).

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources