# Finnhub [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/pipeworx-io/mcp-finnhub  
**GitHub Stars:** 0  
**npm Downloads (last month):** 763  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/finnhub

## Description
Finnhub MCP — wraps Finnhub Stock API (finnhub.io)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "finnhub": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-finnhub"]
  }
}
```

## Documentation

## What Finnhub MCP server does

The Finnhub MCP server exposes Finnhub's REST API to MCP-compatible AI clients. Its data coverage includes stock quotes, company fundamentals, earnings calendars and history, analyst estimates, company news, news sentiment, insider transactions, ETF holdings, economic data, cryptocurrency, and forex.

It is suited to research workflows that need more than a single price lookup. An agent can combine a ticker's current or delayed quote with recent news, earnings information, or insider filings. Finnhub also covers European, Asian, and emerging-market symbols, although international symbols may require exchange suffixes such as `NESN.SW`.

## How it works

The package is available in two forms. A hosted endpoint at `https://gateway.pipeworx.io/finnhub/mcp` provides the Finnhub pack through Pipeworx. The same gateway also offers a full endpoint at `https://gateway.pipeworx.io/mcp`; either endpoint can use the gateway's `ask_pipeworx` routing capability.

The hosted pack endpoint lists its Finnhub tools along with shared Pipeworx meta-tools. The local package exposes only the Finnhub tools over stdin and stdout, without the gateway's shared routing tools. Clients communicate using MCP operations such as `initialize`, `tools/list`, and `tools/call`.

For applications that do not use an MCP client, Pipeworx also documents HTTP access to individual tools. A request can include the caller's Finnhub key as `_apiKey`.

## Setup and configuration

For a hosted connection, add the endpoint to an MCP client configuration:

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

For a standalone local server, use the published npm package:

```json
{
  "mcpServers": {
    "finnhub": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-finnhub"]
    }
  }
}
```

Create a free API key through the Finnhub dashboard and pass it in the `_apiKey` argument when calling tools. The free plan permits 60 API calls per minute. Paid plans provide live data, longer historical access, and higher rate limits.

## Tools and capabilities

The Finnhub MCP server supports workflows involving:

- Real-time or delayed stock quotes
- Company news with sentiment scoring
- Insider transactions from Form 4 filings
- Upcoming earnings, historical surprises, and EPS estimates
- Company fundamentals and analyst estimates
- ETF holdings
- Economic indicators
- Cryptocurrency and foreign-exchange data
- International ticker lookup and market coverage

The gateway's `ask_pipeworx` meta-tool can accept a natural-language question and select a suitable tool across the Pipeworx catalog. Direct tool calls are more appropriate when an application needs explicit control over arguments and data sources.

## Limitations and notes

Rate limits and coverage should be checked before building production workflows around frequent requests.

Finnhub's news sentiment is an NLP-derived signal, so it should not be treated as ground truth. Insider records can arrive after the transaction because Form 4 filings generally have a reporting window of up to two business days. Analyst estimates must also be kept distinct from reported actuals in analysis and charts.

Some smaller-cap and OTC securities may have limited free-tier coverage. Verify that the required symbols return data before depending on them. International symbols often need an exchange suffix, and Finnhub's symbol search can help identify the correct format.

_Full upstream README: https://allmcps.com/mcp/finnhub/readme_