Skip to main content
Glama

Finnhub MCP by usefulapi

by io.usefulapi
OverviewDiscussionsAdmin

Server Details

Quotes, company profiles, fundamentals, earnings and IPO calendars, plus market and company news.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
82.4% over 57 days
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

A4/5.0

Scored across 15 tools

Disambiguation5/5

Each tool targets a distinct resource or data type (company profile, news, earnings, insider transactions, quotes, etc.). The two news tools (company_news vs market_news) and the two earnings tools (calendar vs surprises) are clearly differentiated by description, leaving no ambiguity for an agent.

Naming Consistency5/5

All tool names follow a consistent pattern: the `finnhub_` prefix followed by a lowercase snake_case noun phrase (e.g., `finnhub_company_news`, `finnhub_market_status`). This uniform naming convention makes tool selection predictable.

Tool Count5/5

With 15 tools, the set is well-scoped for a financial data server, covering a broad range of endpoints without unnecessary bloat. Each tool has a clear purpose and corresponds to a meaningful Finnhub API endpoint.

Completeness4/5

The tool set covers core financial data needs: company profile, financials, news, earnings, quotes, recommendations, and market status. Minor gaps exist, such as lack of historical price candles or full financial statements, but these are not critical for the apparent server purpose and most workflows are supported.

Available Tools

15 tools
finnhub_basic_financialsBasic financials
Read-only
Inspect

Key financial metrics for a company — valuation, margins, growth, per-share and 52-week ratios. Finnhub REST: GET /stock/metric.

ParametersJSON Schema
NameRequiredDescriptionDefault
metricNoMetric group to fetch — 'all' (default) returns every available metric.
symbolYesStock ticker symbol, e.g. 'AAPL' (required).
finnhub_company_newsCompany news
Read-only
Inspect

Latest company news for a symbol over a date range (up to 1 year back). Finnhub REST: GET /company-news.

ParametersJSON Schema
NameRequiredDescriptionDefault
toYesEnd date, yyyy-mm-dd (required).
fromYesStart date, yyyy-mm-dd (required).
symbolYesStock ticker symbol, e.g. 'AAPL' (required).
finnhub_company_profileCompany profile
Read-only
Inspect

General company profile — name, country, currency, exchange, industry, market cap, share outstanding, IPO date, logo and more. Provide at least one of symbol, isin or cusip. Finnhub REST: GET /stock/profile2.

ParametersJSON Schema
NameRequiredDescriptionDefault
isinNoISIN identifier (use instead of symbol/cusip).
cusipNoCUSIP identifier (use instead of symbol/isin).
symbolNoStock ticker symbol, e.g. 'AAPL'.
finnhub_earnings_calendarEarnings calendar
Read-only
Inspect

Upcoming and historical earnings release calendar, optionally filtered by date range and/or symbol. Finnhub REST: GET /calendar/earnings.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoEnd date, yyyy-mm-dd (optional).
fromNoStart date, yyyy-mm-dd (optional).
symbolNoFilter the calendar to a single symbol, e.g. 'AAPL'.
finnhub_earnings_surprisesEarnings surprises
Read-only
Inspect

Historical quarterly EPS surprises — actual vs. estimated EPS by period. Finnhub REST: GET /stock/earnings.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoLimit the number of periods returned (most recent first).
symbolYesStock ticker symbol, e.g. 'AAPL' (required).
finnhub_insider_transactionsInsider transactions
Read-only
Inspect

Insider transactions (Form 3/4/5 filings) for a company, optionally within a date range. Finnhub REST: GET /stock/insider-transactions.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoEnd date, yyyy-mm-dd (optional).
fromNoStart date, yyyy-mm-dd (optional).
symbolYesStock ticker symbol, e.g. 'AAPL' (required).
finnhub_ipo_calendarIPO calendar
Read-only
Inspect

IPO calendar for a date range — upcoming and recent initial public offerings. Finnhub REST: GET /calendar/ipo.

ParametersJSON Schema
NameRequiredDescriptionDefault
toYesEnd date, yyyy-mm-dd (required).
fromYesStart date, yyyy-mm-dd (required).
finnhub_market_newsMarket news
Read-only
Inspect

General latest market news by category. Finnhub REST: GET /news.

ParametersJSON Schema
NameRequiredDescriptionDefault
minIdNoOnly return news with an id greater than this (pagination).
categoryNoNews category — 'general' (default), 'forex', 'crypto' or 'merger'.
finnhub_market_statusMarket status
Read-only
Inspect

Current market open/closed status and session for an exchange. Finnhub REST: GET /stock/market-status.

ParametersJSON Schema
NameRequiredDescriptionDefault
exchangeYesExchange code, e.g. 'US' (required).
finnhub_peersCompany peers
Read-only
Inspect

Peer companies for a symbol (same country and GICS sub-industry). Finnhub REST: GET /stock/peers.

ParametersJSON Schema
NameRequiredDescriptionDefault
symbolYesStock ticker symbol, e.g. 'AAPL' (required).
groupingNoPeer grouping criterion, e.g. 'sector', 'industry' or 'subIndustry' (default).
finnhub_price_targetPrice target
Read-only
Inspect

Analyst price targets for a symbol — high / low / median / mean target. Note: this is a premium-tier Finnhub endpoint (may return 403 on the free plan). Finnhub REST: GET /stock/price-target.

ParametersJSON Schema
NameRequiredDescriptionDefault
symbolYesStock ticker symbol, e.g. 'AAPL' (required).
finnhub_quoteReal-time quote
Read-only
Inspect

Real-time quote for a stock — current price (c), change (d), percent change (dp), high (h), low (l), open (o), previous close (pc) and unix timestamp (t). Finnhub REST: GET /quote.

ParametersJSON Schema
NameRequiredDescriptionDefault
symbolYesStock ticker symbol, e.g. 'AAPL' (required).
finnhub_stock_symbolsStock symbols
Read-only
Inspect

List all symbols supported on an exchange. Finnhub REST: GET /stock/symbol.

ParametersJSON Schema
NameRequiredDescriptionDefault
micNoFilter by Market Identifier Code (MIC).
currencyNoFilter by trading currency, e.g. 'USD'.
exchangeYesExchange code, e.g. 'US' (required).
securityTypeNoFilter by security type, e.g. 'Common Stock'.

Tool Schema Changelog

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

  1. 15 tool updates
    • Changedfinnhub_basic_financials1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_company_news1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_company_profile1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_earnings_calendar1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_earnings_surprises1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_insider_transactions1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_ipo_calendar1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_market_news1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_market_status1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_peers1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_price_target1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_quote1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_recommendation_trends1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_stock_symbols1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedfinnhub_symbol_search1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. 15 tool updates
    • First observedfinnhub_basic_financials
    • First observedfinnhub_company_news
    • First observedfinnhub_company_profile
    • First observedfinnhub_earnings_calendar
    • First observedfinnhub_earnings_surprises
    • First observedfinnhub_insider_transactions
    • First observedfinnhub_ipo_calendar
    • First observedfinnhub_market_news
    • First observedfinnhub_market_status
    • First observedfinnhub_peers
    • First observedfinnhub_price_target
    • First observedfinnhub_quote
    • First observedfinnhub_recommendation_trends
    • First observedfinnhub_stock_symbols
    • First observedfinnhub_symbol_search

Related MCP Connectors

Related MCP Servers

  • akyla-mcp by AkilaAnalytics

    akyla-mcpofficial

    AkilaAnalytics
    A
    license
    A
    quality
    D
    maintenance
    Provides as-reported US equity fundamentals, live quotes, financial statements, valuation comps, and a screener from SEC filings, with per-cell filing provenance for citations.
    7
    MIT

  • yahoo-finance-mcp

    nrempel
    A
    license
    A
    quality
    C
    maintenance
    Provides access to Yahoo Finance data including real-time stock quotes, historical prices, financial statements, company info, symbol search, and news.
    6
    42 npm
    1
    MIT
Try in Browser
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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources