Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

finnhub-mcp

SalZaki309MIT1.11.0

A Model Context Protocol server for Finnhub financial data

mcp, finnhub, financial, data, model-context-protocol, server

readme

Finnhub MCP Server

A Model Context Protocol (MCP) server that provides real-time financial data through the Finnhub API.

Installation

npm install -g finnhub-mcp

Or run directly with npx:

npx finnhub-mcp

Usage

Prerequisites

You'll need a Finnhub API key. Get one free at https://finnhub.io.

Environment Variables

Set your Finnhub API key:

export FINNHUB_API_KEY=your_api_key

Running the Server

finnhub-mcp

Or with npx:

FINNHUB_API_KEY=your_api_key npx finnhub-mcp

VS Code Integration

Add this to your MCP configuration in VS Code:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "finnhub-key",
      "description": "Finnhub API Key",
      "password": true
    }
  ],
  "servers": {
    "Finnhub": {
      "type": "stdio",
      "command": "npx",
      "args": ["finnhub-mcp", "--stdio", "--urls", "http://localhost:3000"],
      "env": {
        "FINNHUB_API_KEY": "${input:finnhub-key}"
      }
    }
  }
}

Claude Integration

Add this to claude_desktop_config.json file in Claude desktop:

{
  "mcpServers": {
    "finnhub-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["finnhub-mcp", "--stdio", "--urls", "http://localhost:3000"],
      "env": {
        "FINNHUB_API_KEY": "your_api_key"
      }
    }
  }
}

Tools

  • Real-time financial data streaming
  • Server-Sent Events (SSE) support
  • Standard input/output (STDIO) transport
  • Integration with Finnhub API

License

MIT

Repository

https://github.com/salzaki/finnhub-mcp

changelog

Changelog

1.11.0 (2025-08-11)

Features

  • resource: add exchange resource (a3d1d4a)
  • resource: add exchange resource (3249c80)
  • resource: add GetAllExchanges feature (dad8df0)

1.10.2 (2025-08-03)

Bug Fixes

  • ci: add bash shell to all build steps in release.yml (3b6d4a6)
  • ci: add bash shell to all build steps in release.yml (0a176ba)

1.10.1 (2025-08-02)

Bug Fixes

  • resolve executable detection in prepare artifact step (ed77cd3)
  • resolve executable detection in prepare artifact step (37b484f)

1.10.0 (2025-08-02)

Features

  • ci: : use POSIX-compatible executable detection in release.yml (15beb0f)
  • ci: : use POSIX-compatible executable detection in release.yml (c6ff3eb)

1.9.0 (2025-08-02)

Features

  • ci: disable PublishTrimmed and partial TrimMode in release pipeline (7d8f2d3)
  • ci: disable PublishTrimmed and partial TrimMode in release pipeline (f6ef4ae)

1.8.0 (2025-08-02)

Features

  • ci: improve release workflow with better error handling (63ff5b2)
  • ci: improve release workflow with better error handling (e1e9cc7)

1.7.0 (2025-08-02)

Features

  • ci: add supported runtime identifiers from build matrix (2144625)
  • ci: add supported runtime identifiers from build matrix (c84f0fa)

1.6.0 (2025-08-01)

Features

  • app: update release (040db5e)
  • app: update release and app start-up (06f2027)
  • app: update release and app startup (a09918f)

1.5.0 (2025-07-29)

Features

  • config: resolve appsettings.json path relative to binary directory (97e6959)
  • config: resolve appsettings.json path relative to binary directory (0ea9cb7)

1.4.0 (2025-07-29)

Features

Bug Fixes

  • ci: fix dotnet publish error (2ea8ff1)
  • ci: fix dotnet publish error (13e6e2f)

1.3.0 (2025-07-29)

Features

  • ci: update release, readme and banner image (873e770)
  • ci: update release, readme and banner image (4574441)

1.2.0 (2025-07-27)

Features

  • tool: release finnhub api integration and search symbol tool wi… (0fd720f)
  • tool: release finnhub api integration and search symbol tool with ARM64 macOS support (89d3564)

1.1.0 (2025-07-27)

Features

  • tool: release finnhub api integration and search symbol tool (c14c9d1)
  • tool: release finnhub api integration and search symbol tool (d2d343c)