Skip to main content
Glama
blpapi-mcp

blpapi-mcp

by djsamseng

BLPAPI-MCP

A MCP server providing financial data from Bloomberg's blpapi.

Note: A Bloomberg Terminal must be running (BBComm must be accessible) for data access.

Installation

Using UV

uv add git+https://github.com/djsamseng/blpapi-mcp

Related MCP server: Bloomberg MCP

Run the MCP Server

uv run blpapi-mcp --sse --host 127.0.0.1 --port 8000

Using blpapi-cmp from Cursor

  • For project only: create .cursor/mcp.json in your project directory

  • For global: create ~/.cursor/mcp.json

  • Replace the host and port with the MCP server running from above

{
  "mcpServers": {
    "server-name": {
      "url": "http://127.0.0.1:8000/sse",
    }
  }
}

Using blpapi-mcp from Claude Code

  • Replace the url with the MCP server running from above

claud mcp add --transport sse blpapi-mcp http://127.0.0.1:8000/sse

Using blpapi-mcp from Aider

Development

Requirements

  1. Install UV

curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Clone this repository

git clone https://github.com/djsamseng/blpapi-mcp
  1. Setup the venv

uv venv
source .venv/bin/activate
  1. Run the MCP server

uv run blpapi-mcp --sse --host 127.0.0.1 --port 8000
  1. Run a test client that starts up it's own server in stdio mode

uv run examples/clients/blp_stdio_client.py
  1. Run a test client that uses an existing running sse server

uv run examples/clients/blp_sse_client.py --host http://127.0.0.1 --port 8000

Trademark Note

This project not affiliated with Bloomberg Finance L.P. The use of the name Bloomberg is only descriptive as towards what this package is used with.

Available Tools

9 tools
bdhC

Get Bloomberg historical data

Inputs: tickers (required), flds (required), start_date, end_date, +2 more.

bdibC

Get Bloomberg intraday bar data

Inputs: ticker (required), dt (required), session, typ, +1 more.

bdpD

Get Bloomberg reference data

Inputs: tickers (required), flds (required), kwargs (required).

bdsC

Get Bloomberg block data

Inputs: tickers (required), flds (required), use_port, kwargs.

bdtickC

Get Bloomberg tick data

Inputs: ticker (required), dt (required), session, time_range, +2 more.

beqsD

Get Bloomberg equity screening

Inputs: screen (required), asof, typ, group, +1 more.

dividendD

Get Bloomberg divident / split history

Inputs: tickers (required), typ, start_date, end_date, +1 more.

earningC

Get Bloomberg earning exposure by Geo or Products

Inputs: ticker (required), by, typ, ccy, +2 more.

turnoverC

Calculate the adjusted turnover (in millions)

Inputs: tickers (required), flds, start_date, end_date, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.5/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool targets a distinct Bloomberg data type (historical, intraday, reference, block data, ticks, screening, dividends, earnings, turnover), with clear descriptions preventing confusion.

    Naming Consistency3/5

    Tool names mix Bloomberg-specific acronyms (bdh, bdib, bdp, bds, bdtick, beqs) with full words (dividend, earning, turnover), lacking a uniform pattern. Acronyms vary in length and structure.

    Tool Count5/5

    Nine tools cover the core Bloomberg data retrieval needs without overloading; the count is appropriate for a financial data server.

    Completeness4/5

    Covers major data types (historical, intraday, reference, screening) but misses real-time data and some corporate actions (e.g., stock splits, M&A). Minor gaps exist but core workflows are functional.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides Model Context Protocol tools for accessing Bloomberg Terminal data including BDP, BDH, BDIB, BQL, bond analytics, screening, and field search.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that bridges AI assistants with Bloomberg Terminal data. It exposes 18 tools for reference, historical, technical analysis, screening, and calendar data through natural language.
      MIT
    • F
      license
      B
      quality
      C
      maintenance
      Enables financial data retrieval, company context, market information, financial modelling, and valuation through MCP tools, with a deterministic sample provider for testing before connecting live data sources.
      15
      -
    • F
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to access Bloomberg data through official BLPAPI, including reference, historical, and intraday data, instrument and field search, and equity screening, with deterministic mock data as a fallback.
      8
      -