# Benzinga — how to use (mcp.ai)

Connect your Benzinga account and use 10 tools for analytics straight from your AI agent. Connect with your own API key. Benzinga provides real-time financial news and data APIs, offering comprehensive coverage of market-moving information for developers and financial professionals.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_benzinga?ms=1787291100000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `benzinga_get_calendar_earnings_stream`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/benzinga`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/benzinga/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/benzinga/get/calendar/earnings/stream` — Tool to subscribe to real-time earnings calendar events via WebSocket. Use when you need immediate updates as reports are announced.
  - body: { isins?: string, tickers?: string }
- `POST https://api.mcp.ai/api/benzinga/get/conference/calls/v21` — Tool to retrieve conference call data for a selected period and/or security using v2.1 API. Conference calls are scheduled calls where company management discusses quarterly or annual financial result
  - body: { date?: string, page?: integer, date_to?: string, tickers?: string, updated?: integer, pagesize?: integer, date_from?: string }
- `POST https://api.mcp.ai/api/benzinga/get/consensus/ratings` — Get aggregated consensus analyst ratings and price targets for a stock ticker. Returns analyst sentiment distribution (strong_buy, buy, hold, sell counts or percentages), consensus rating, price targe
  - body: { pagesize?: integer, simplify?: boolean, parameters?: object, aggregate_type?: string }
- `POST https://api.mcp.ai/api/benzinga/get/earnings/v21` — Tool to retrieve earnings calendar data (v2.1). Use when you need dates, estimates, and actuals for upcoming earnings events.
  - body: { date?: string, page?: integer, date_to?: string, tickers?: string[], updated?: integer, pagesize?: integer, date_from?: string, date_sort?: string, importance?: integer }
- `POST https://api.mcp.ai/api/benzinga/get/economics/v21` — Tool to retrieve economic calendar data including indicators, releases, and reports from various countries. Returns actual values, consensus estimates, and prior values for economic events such as GDP
  - body: { date?: string, page?: integer, country?: string, date_to?: string, updated?: integer, pagesize?: integer, date_from?: string, importance?: integer, event_category?: string }
- `POST https://api.mcp.ai/api/benzinga/get/news/channels` — Tool to retrieve all available news channels that can be used to filter news items. Use when you need to discover available channel categories for news filtering. Channels can have sub-channels (ident
- `POST https://api.mcp.ai/api/benzinga/get/newsfeed/stream` — Get WebSocket connection details for real-time Benzinga newsfeed streaming. Returns the WebSocket URL and authentication token needed to establish a WebSocket connection for receiving real-time news e
- `POST https://api.mcp.ai/api/benzinga/get/ratings/v21` — Tool to fetch analyst ratings data including upgrades, downgrades, initiations, and price target changes from Wall Street analysts. Returns current and prior ratings, price targets, analyst informatio
  - body: { date?: string, firm?: string, page?: integer, action?: string, fields?: string, analyst?: string, date_to?: string, firm_id?: string, tickers?: string, updated?: integer, pagesize?: integer, simplify?: boolean, date_from?: string, analyst_id?: string, importance?: integer }
- `POST https://api.mcp.ai/api/benzinga/get/removed/news` — Retrieves IDs and timestamps of news articles that have been removed from Benzinga's database. Use this to track deleted/retracted news articles, sync local caches, or identify articles removed after 
  - body: { page?: integer, updated?: integer, pagesize?: integer }
- `POST https://api.mcp.ai/api/benzinga/get/removed/v21` — Tool to retrieve removed or cancelled calendar events from Benzinga (v2.1). Use when you need to track calendar events that have been deleted or cancelled from specific event types like earnings, rati
  - body: { page?: integer, type?: string, updated?: integer, pageSize?: integer }

## Example prompts
- "What can I do in Benzinga?"
- "Show me a summary of my Benzinga account"

## More
- Page: https://mcp.ai/benzinga
- Agent spec (llms.txt): https://mcp.ai/benzinga/llms.txt
- Postman collection: https://mcp.ai/benzinga/postman.json