Benzinga Finance MCP Server

A Model Context Protocol (MCP) server that exposes Benzinga market data APIs for delayed stock quotes and historical OHLCV price bars. It uses your Benzinga API key (Data API Proxy / subscription) for authentication.

Features

• get_delayed_quotes — Get delayed (near real-time) quotes for one or more symbols. Returns last price, bid/ask, volume, change, 52-week range, market cap, P/E, and related fields. Supports lookup by symbols, ISIN, or CIK.
• get_historical_bars — Get historical OHLCV bars for specified symbols. Supports intervals: 1m, 5m, 15m, 30m, 1h, 1d, 1w, 1M, and flexible date ranges (absolute or relative like 1MONTH, YTD).

All tools return markdown-formatted responses and use the same logging and error-handling patterns as the reference MCP implementation.

Prerequisites

• A Benzinga API key with access to the Data API Proxy (Quotes and Bars).
• Node.js >= 18.

Installation

npm install

Build and run

npm run build
npm start

Development (run without building):

npm run dev

Usage

The server reads configuration from @hikari-systems/hs.utils (e.g. env or config) and optional CLI args:

• Config keys: benzinga:url (optional, default https://api.benzinga.com), benzinga:apiKey (required).
• CLI: benzinga-finance-mcp [base-url] <api-key>
  • If you pass two arguments, the first is the base URL and the second is the API key.
  • If you pass one argument, it is used as the API key and the default base URL is used.

Examples:

# Using CLI (one arg = API key, default base URL)
node dist/index.js YOUR_BENZINGA_API_KEY

# Using CLI (base URL + API key)
node dist/index.js https://api.benzinga.com YOUR_BENZINGA_API_KEY

With npx (after publish):

npx @hikari-systems/benzinga-finance-mcp YOUR_BENZINGA_API_KEY

Adding to Cursor

1. Open Settings → Features → Model Context Protocol → Servers.
2. Add a server entry, for example:

{
  "mcpServers": {
    "benzinga-finance": {
      "command": "npx",
      "args": [
        "@hikari-systems/benzinga-finance-mcp",
        "YOUR_BENZINGA_API_KEY"
      ]
    }
  }
}

Or use config/env so the key is not in the JSON:

{
  "mcpServers": {
    "benzinga-finance": {
      "command": "node",
      "args": ["/path/to/benzinga-mcp/dist/index.js"],
      "env": {
        "benzinga__apiKey": "YOUR_BENZINGA_API_KEY"
      }
    }
  }
}

Replace YOUR_BENZINGA_API_KEY with your actual key and, if needed, adjust command/args to your install path.

API reference

• Delayed quotes: Benzinga – Get delayed quotes.
• Historical bars: Benzinga – Get bars.
• Authentication: Benzinga – Authentication (this server uses the recommended Authorization: token <key> header).

License

Apache-2.0