# io.usefulapi/finnhub (remote · finnhub.usefulapi.io)

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

- Trust score: 71/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-04

## Components

- remote · `finnhub.usefulapi.io`: 71/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-finnhub/finnhub.md), [page](https://verifymcp.io/servers/io-usefulapi-finnhub/finnhub)

## Channel facts

- Endpoint: `https://finnhub.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-04.

- **Endpoint Security**: 78/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1235 tokens (~82/item across 15 items; 15 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### Claude

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

### Codex

```toml
[mcp_servers.io-usefulapi-finnhub]
url = "https://finnhub.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-finnhub": {
      "type": "remote",
      "url": "https://finnhub.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-finnhub --url https://finnhub.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-finnhub:
    url: "https://finnhub.usefulapi.io/mcp"
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-04 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-03 (score 70, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-08-02 (score 70, +52)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [security] First check of Authorization: partial
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: pass
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail

### 2026-08-01 (score 18)

First indexed and scored.

## MCP tools (15)

### `finnhub_quote` (~82 tokens)

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.

Input parameters:

- `symbol` (string, required): Stock ticker symbol, e.g. 'AAPL' (required).

### `finnhub_symbol_search` (~82 tokens)

Symbol search

Search for stock symbols by name or ticker — returns best-matching symbols with descriptions and types. Finnhub REST: GET /search.

Input parameters:

- `exchange` (string): Restrict results to an exchange, e.g. 'US'.
- `q` (string, required): Free-text query — a company name or ticker, e.g. 'apple' (required).

### `finnhub_company_profile` (~118 tokens)

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.

Input parameters:

- `cusip` (string): CUSIP identifier (use instead of symbol/isin).
- `isin` (string): ISIN identifier (use instead of symbol/cusip).
- `symbol` (string): Stock ticker symbol, e.g. 'AAPL'.

### `finnhub_company_news` (~88 tokens)

Company news

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

Input parameters:

- `from` (string, required): Start date, yyyy-mm-dd (required).
- `symbol` (string, required): Stock ticker symbol, e.g. 'AAPL' (required).
- `to` (string, required): End date, yyyy-mm-dd (required).

### `finnhub_market_news` (~72 tokens)

Market news

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

Input parameters:

- `category` (string): News category — 'general' (default), 'forex', 'crypto' or 'merger'.
- `minId` (integer): Only return news with an id greater than this (pagination).

### `finnhub_basic_financials` (~86 tokens)

Basic financials

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

Input parameters:

- `metric` (string): Metric group to fetch — 'all' (default) returns every available metric.
- `symbol` (string, required): Stock ticker symbol, e.g. 'AAPL' (required).

### `finnhub_recommendation_trends` (~67 tokens)

Recommendation trends

Analyst recommendation trends over time — counts of strong buy / buy / hold / sell / strong sell by period. Finnhub REST: GET /stock/recommendation.

Input parameters:

- `symbol` (string, required): Stock ticker symbol, e.g. 'AAPL' (required).

### `finnhub_earnings_surprises` (~75 tokens)

Earnings surprises

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

Input parameters:

- `limit` (integer): Limit the number of periods returned (most recent first).
- `symbol` (string, required): Stock ticker symbol, e.g. 'AAPL' (required).

### `finnhub_price_target` (~78 tokens)

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.

Input parameters:

- `symbol` (string, required): Stock ticker symbol, e.g. 'AAPL' (required).

### `finnhub_peers` (~84 tokens)

Company peers

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

Input parameters:

- `grouping` (string): Peer grouping criterion, e.g. 'sector', 'industry' or 'subIndustry' (default).
- `symbol` (string, required): Stock ticker symbol, e.g. 'AAPL' (required).

### `finnhub_insider_transactions` (~97 tokens)

Insider transactions

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

Input parameters:

- `from` (string): Start date, yyyy-mm-dd (optional).
- `symbol` (string, required): Stock ticker symbol, e.g. 'AAPL' (required).
- `to` (string): End date, yyyy-mm-dd (optional).

### `finnhub_stock_symbols` (~97 tokens)

Stock symbols

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

Input parameters:

- `currency` (string): Filter by trading currency, e.g. 'USD'.
- `exchange` (string, required): Exchange code, e.g. 'US' (required).
- `mic` (string): Filter by Market Identifier Code (MIC).
- `securityType` (string): Filter by security type, e.g. 'Common Stock'.

### `finnhub_market_status` (~52 tokens)

Market status

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

Input parameters:

- `exchange` (string, required): Exchange code, e.g. 'US' (required).

### `finnhub_earnings_calendar` (~91 tokens)

Earnings calendar

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

Input parameters:

- `from` (string): Start date, yyyy-mm-dd (optional).
- `symbol` (string): Filter the calendar to a single symbol, e.g. 'AAPL'.
- `to` (string): End date, yyyy-mm-dd (optional).

### `finnhub_ipo_calendar` (~66 tokens)

IPO calendar

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

Input parameters:

- `from` (string, required): Start date, yyyy-mm-dd (required).
- `to` (string, required): End date, yyyy-mm-dd (required).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-finnhub/finnhub#diagnostics

## Score history

- 2026-08-04: 71
- 2026-08-03: 70
- 2026-08-02: 70
- 2026-08-01: 18

## Links

- Remote endpoint: https://finnhub.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-finnhub/finnhub/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-finnhub/finnhub/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-finnhub/finnhub