Finnhub MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.3Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinance

Overview

AI-generated overview

Hosted Finnhub server that lets an assistant pull stock quotes, company profiles, fundamentals, earnings and IPO calendars, and market news.

What you can do
  • Look up real-time quotes, search symbols, list exchange symbols and check market open/closed status
  • Read company profiles, key financial metrics, peers and insider transactions
  • Review analyst recommendation trends, price targets and quarterly EPS surprises
  • Retrieve company news and general market news by category
  • Check earnings and IPO calendars for a date range
  • Report usage, request a missing feature, and upgrade or cancel a paid plan
When to use it
Useful when you want an assistant to answer questions about stock prices, company fundamentals, analyst views, insider activity, or upcoming earnings and IPOs without building your own Finnhub integration. It suits occasional research and light automation rather than high-volume data pipelines.
Requirements
A remote MCP endpoint connected by URL; no local install. Sign-in uses OAuth, and the login page asks for your own Finnhub API key, which is validated and stored per user. A Finnhub account is required; the free tier works. Internet access to the hosted endpoint.
Before you install
The free plan allows only 50 tool calls per month; paid plans cost money (Pro at $9/month or $90/year, Pro+ at $39/month or $390/year) and are billed through a Stripe checkout link returned by the upgrade tool. Cancelling stops renewal at the end of the paid period with no refund for the current period. Your Finnhub API key is entered at the provider's login page, so trust that host. The price target tool is a premium Finnhub endpoint that may return 403 on a free plan.

Installation

In SourceWeft

  1. Open Finnhub MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Ffinnhub/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "finnhub-by-usefulapi": {
      "type": "http",
      "url": "https://finnhub.usefulapi.io/mcp"
    }
  }
}

README

Finnhub MCP by usefulapi

Use your Finnhub account from Claude, Cursor, or any MCP client — pull quotes, company profiles, fundamentals, earnings and IPO calendars, and market or company news. Hosted, no local install: connect with your own credentials.

Live endpoint: https://finnhub.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://finnhub.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http finnhub https://finnhub.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "finnhub": {      "url": "https://finnhub.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Finnhub credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/finnhub/

On first connect you'll provide your Finnhub API key (shown on your Finnhub dashboard — the free tier works). It is validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
finnhub_quotereadReal-time quote
finnhub_symbol_searchreadSymbol search
finnhub_company_profilereadCompany profile
finnhub_company_newsreadCompany news
finnhub_market_newsreadMarket news
finnhub_basic_financialsreadBasic financials
finnhub_recommendation_trendsreadRecommendation trends
finnhub_earnings_surprisesreadEarnings surprises
finnhub_price_targetreadPrice target
finnhub_peersreadCompany peers
finnhub_insider_transactionsreadInsider transactions
finnhub_stock_symbolsreadStock symbols
finnhub_market_statusreadMarket status
finnhub_earnings_calendarreadEarnings calendar
finnhub_ipo_calendarreadIPO calendar
finnhub_usage_statusmetaUsage status (free-tier meter)
finnhub_request_featuremetaRequest a missing feature
finnhub_upgrademetaUpgrade to Pro or Pro+
finnhub_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with finnhub_upgrade (it returns a Stripe Checkout link). Cancel any time with finnhub_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running finnhub_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/finnhub/README.md at commit 4046075

Tools

15

finnhub_quote

Real-time quote

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.

Parameterssymbolrequired

finnhub_company_profile

Company profile

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.

Parametersisincusipsymbol

finnhub_company_news

Company news

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

Parameterstorequiredfromrequiredsymbolrequired

finnhub_market_news

Market news

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

ParametersminIdcategory

finnhub_basic_financials

Basic financials

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

Parametersmetricsymbolrequired

finnhub_earnings_surprises

Earnings surprises

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

Parameterslimitsymbolrequired

finnhub_price_target

Price target

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.

Parameterssymbolrequired

finnhub_peers

Company peers

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

Parameterssymbolrequiredgrouping

finnhub_insider_transactions

Insider transactions

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

Parameterstofromsymbolrequired

finnhub_stock_symbols

Stock symbols

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

ParametersmiccurrencyexchangerequiredsecurityType

finnhub_market_status

Market status

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

Parametersexchangerequired

finnhub_earnings_calendar

Earnings calendar

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

Parameterstofromsymbol

finnhub_ipo_calendar

IPO calendar

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

Parameterstorequiredfromrequired

Version history

21
  1. v1.36.3LatestNov 7, 2026
  2. v1.35.3Nov 5, 2026
  3. v1.35.2Nov 5, 2026
  4. v1.35.1Nov 4, 2026
  5. v1.35.0Nov 3, 2026
  6. v1.34.1Nov 3, 2026
  7. v1.33.0Nov 1, 2026
  8. v1.31.0Oct 31, 2026
  9. v1.30.0Oct 31, 2026
  10. v1.29.2Oct 30, 2026
  11. v1.29.0Oct 30, 2026
  12. v1.24.0Oct 26, 2026
  13. v1.21.3Oct 25, 2026
  14. v1.21.0Oct 25, 2026
  15. v1.20.0Oct 24, 2026
  16. v1.17.0Oct 23, 2026
  17. v1.16.4Oct 22, 2026
  18. v1.16.3Oct 21, 2026
  19. v1.11.1Oct 9, 2026
  20. v1.10.0Oct 9, 2026
  21. v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations