INDIVIDUAL MCP TOOL

finnhub_earnings_surprises

Historical quarterly EPS surprises — actual vs.

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://finnhub.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for finnhub_earnings_surprises and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.finnhub-mcp]
url = "https://finnhub.usefulapi.io/mcp"
enabled = true

Claude Code

.mcp.json

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

Claude Desktop

Settings → Connectors → Add custom connector

Name: finnhub-mcp
Remote MCP URL: https://finnhub.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "finnhub-mcp": {
      "url": "https://finnhub.usefulapi.io/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

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

Generic MCP

Client-specific MCP configuration

{
  "name": "finnhub-mcp",
  "transport": "streamable-http",
  "url": "https://finnhub.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

finnhub_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_symbol_search — Search for stock symbols by name or ticker — returns best-matching symbols with descriptions and types.
finnhub_company_profile — General company profile — name, country, currency, exchange, industry, market cap, share outstanding, IPO date, logo and more.
finnhub_company_news — Latest company news for a symbol over a date range (up to 1 year back).
finnhub_market_news — General latest market news by category.
finnhub_basic_financials — Key financial metrics for a company — valuation, margins, growth, per-share and 52-week ratios.
finnhub_recommendation_trends — Analyst recommendation trends over time — counts of strong buy / buy / hold / sell / strong sell by period.
finnhub_price_target — Analyst price targets for a symbol — high / low / median / mean target.