Finnhub

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:

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

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

{
  "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.