# Finnhub MCP by usefulapi

> Finnhub MCP by usefulapi is a freemium MCP server for finance and payments. Finnhub market data (quotes, fundamentals, earnings, news) inside Claude and ChatGPT. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API
- **Website:** https://usefulapi.io/finnhub/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/finnhub
- **MCP Registry name:** io.usefulapi/finnhub
- **Categories:** finance and payments
- **Listing updated:** 2026-11-18

## About

The README describes a hosted MCP endpoint that lets an AI assistant query Finnhub market data through your own Finnhub account. Instead of installing anything locally, you add one URL to a client such as Claude, ChatGPT, Cursor or VS Code, then sign in with your Finnhub API key on a login page.

The server exposes 15 read-only tools covering real-time quotes, symbol search, company profiles, basic financials, analyst recommendation trends, earnings surprises, peers, insider filings, market status, earnings and IPO calendars, and company and market news. Four further tools handle usage checks, feature requests and subscription changes. The site says the free tier allows 50 tool calls a month, with paid Pro and Pro+ plans for higher limits.

The product is aimed at investors and analysts who want to ask natural-language questions about listed companies. usefulapi states it is an independent service and not affiliated with Finnhub.

## Features

- **Hosted remote connector:** Runs as a Streamable HTTP endpoint, so no local install is needed beyond adding the URL to a client.
- **Read-only market tools:** The 15 data tools are marked read-only, so the assistant cannot change data in the Finnhub account.
- **OAuth sign-in with API key:** Authentication happens through a login page where the user enters their Finnhub API key rather than placing keys in config files.
- **Earnings and IPO calendars:** Lists upcoming and historical earnings releases and initial public offerings for a date range or symbol.
- **Analyst and insider data:** Provides recommendation trends, earnings surprises, price targets and Form 3, 4 and 5 insider transactions.
- **Usage metering:** A usage status tool reports calls used against the plan's monthly limit.

## Good for

- Checking a stock's current price and company profile during research
- Comparing a company's valuation and growth metrics with its industry peers
- Reviewing analyst recommendation trends and past earnings results
- Tracking upcoming earnings reports and IPOs for a given week
- Scanning recent company or general market news headlines
- Reviewing recent insider buying and selling activity

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http finnhub https://finnhub.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://finnhub.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "finnhub": {
      "serverUrl": "https://finnhub.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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 REST: GET /quote.
- `finnhub_symbol_search`: Search for stock symbols by name or ticker — returns best-matching symbols with descriptions and types. Finnhub REST: GET /search.
- `finnhub_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_news`: Latest company news for a symbol over a date range (up to 1 year back). Finnhub REST: GET /company-news.
- `finnhub_market_news`: General latest market news by category. Finnhub REST: GET /news.
- `finnhub_basic_financials`: Key financial metrics for a company — valuation, margins, growth, per-share and 52-week ratios. Finnhub REST: GET /stock/metric.
- `finnhub_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_surprises`: Historical quarterly EPS surprises — actual vs. estimated EPS by period. Finnhub REST: GET /stock/earnings.
- `finnhub_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_peers`: Peer companies for a symbol (same country and GICS sub-industry). Finnhub REST: GET /stock/peers.
- `finnhub_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_symbols`: List all symbols supported on an exchange. Finnhub REST: GET /stock/symbol.
- `finnhub_market_status`: Current market open/closed status and session for an exchange. Finnhub REST: GET /stock/market-status.
- `finnhub_earnings_calendar`: Upcoming and historical earnings release calendar, optionally filtered by date range and/or symbol. Finnhub REST: GET /calendar/earnings.
- `finnhub_ipo_calendar`: IPO calendar for a date range — upcoming and recent initial public offerings. Finnhub REST: GET /calendar/ipo.

## FAQ

### Is this an official Finnhub product?

No. The site says usefulapi is an independent service and is not affiliated with or endorsed by Finnhub.

### What do I need to connect?

The login page asks for your Finnhub API key, which is shown on your Finnhub dashboard. The README says the free tier works.

### Which AI clients can I use?

Any client that supports remote MCP servers with OAuth login, including Claude, Claude Code, ChatGPT, Codex, Cursor and VS Code, according to the site.

### What does it cost?

The Free plan gives 50 tool calls a month. Pro is $9/mo or $90/yr for 10,000 calls, and Pro+ is $39/mo or $390/yr for 100,000 calls.

### Is Finnhub MCP by usefulapi free?

Finnhub MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Finnhub MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http finnhub https://finnhub.usefulapi.io/mcp

### What are the best alternatives to Finnhub MCP by usefulapi?

The closest alternatives to Finnhub MCP by usefulapi are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 14 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/finnhub-mcp-by-usefulapi
