usefulapi

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

Claude

  1. Open Settings → Connectors → Add custom connector
  2. Paste this URL:
    https://finnhub.usefulapi.io/mcp
  3. Authenticate with Finnhub when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "finnhub": {
      "url": "https://finnhub.usefulapi.io/mcp"
    }
  }
}
live17 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 17

ToolTypeWhat it does
finnhub_quoteread
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.
finnhub_symbol_searchread
Symbol search
Search for stock symbols by name or ticker — returns best-matching symbols with descriptions and types. Finnhub REST: GET /search.
finnhub_company_profileread
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.
finnhub_company_newsread
Company news
Latest company news for a symbol over a date range (up to 1 year back). Finnhub REST: GET /company-news.
finnhub_market_newsread
Market news
General latest market news by category. Finnhub REST: GET /news.
finnhub_basic_financialsread
Basic financials
Key financial metrics for a company — valuation, margins, growth, per-share and 52-week ratios. Finnhub REST: GET /stock/metric.
finnhub_recommendation_trendsread
Recommendation trends
Analyst recommendation trends over time — counts of strong buy / buy / hold / sell / strong sell by period. Finnhub REST: GET /stock/recommendation.
finnhub_earnings_surprisesread
Earnings surprises
Historical quarterly EPS surprises — actual vs. estimated EPS by period. Finnhub REST: GET /stock/earnings.
finnhub_price_targetread
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.
finnhub_peersread
Company peers
Peer companies for a symbol (same country and GICS sub-industry). Finnhub REST: GET /stock/peers.
finnhub_insider_transactionsread
Insider transactions
Insider transactions (Form 3/4/5 filings) for a company, optionally within a date range. Finnhub REST: GET /stock/insider-transactions.
finnhub_stock_symbolsread
Stock symbols
List all symbols supported on an exchange. Finnhub REST: GET /stock/symbol.
finnhub_market_statusread
Market status
Current market open/closed status and session for an exchange. Finnhub REST: GET /stock/market-status.
finnhub_earnings_calendarread
Earnings calendar
Upcoming and historical earnings release calendar, optionally filtered by date range and/or symbol. Finnhub REST: GET /calendar/earnings.
finnhub_ipo_calendarread
IPO calendar
IPO calendar for a date range — upcoming and recent initial public offerings. Finnhub REST: GET /calendar/ipo.
finnhub_usage_statusmeta
Usage status (free-tier meter)
Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached.
finnhub_upgrademeta
Upgrade to Pro (unlimited)
Subscribe to Pro for unlimited tool calls, monthly ($9) or yearly ($90). Returns a Stripe Checkout link.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro$9/mo · $90/yrUnlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.