Bloomberg MCP Server

A self-documenting Model Context Protocol server for Bloomberg Terminal data access. Works with any MCP client — Claude Code, Cursor, VS Code, LM Studio, or custom agents — without requiring a separate skill file or prompt injection.

Features

• 12 tools — status/reset, BDP, BDH, BDIB, BQL, bond analytics, screening, field search, reference docs, examples

• 17 BQL reference files — comprehensive syntax documentation served as MCP resources

• 27 verified test queries — covering equity, fixed income, credit, CDS, returns, curves, and funds

• xbbg-first execution - BDP, BDH, BDIB, BQL, screening, field search, and bond analytics use xbbg with stable pandas/wide output

• In-process BQL - BQL runs in-process via blpapi; no separate BQNT environment required

• Self-documenting — BQL syntax rules embedded in tool descriptions; no external skill file needed

Related MCP server: Formula1 MCP Server

Prerequisites

• Bloomberg Terminal — must be running and logged in

• uv — provisions the project's Python 3.11+ environment automatically; the setup script installs it if missing

Installation

Agent-friendly setup

On a Bloomberg Terminal workstation, Claude or Codex can install and configure the MCP with:

git clone https://github.com/sbctreasury/bloomberg-mcp.git
cd bloomberg-mcp
powershell -ExecutionPolicy Bypass -File .\scripts\setup-bloomberg-mcp.ps1

The setup script:

• Finds or installs uv for the current Windows user

• Runs uv sync against the repo lockfile to create/update the project .venv

• Persists the BLOOMBERG_MCP_HOME user environment variable

• Writes a project .mcp.json

• Updates Claude Desktop at %APPDATA%\Claude\claude_desktop_config.json

• Optionally registers Claude Code with -RegisterClaudeCode (Claude Code auto-discovers the bundled plugin otherwise)

• Updates Codex at %USERPROFILE%\.codex\config.toml or $CODEX_HOME\config.toml

• Verifies Bloomberg Terminal/API connectivity with a bounded probe

Restart Claude Desktop, Claude Code, or Codex after setup so the client reloads MCP configuration.

Manual setup

1. Clone the repo

git clone https://github.com/sbctreasury/bloomberg-mcp.git

2. Configure your MCP client

Option A: Setup script (recommended)

The setup script installs uv if needed, syncs the project environment, and writes MCP configs with resolved user-specific paths.

powershell -ExecutionPolicy Bypass -File .\scripts\setup-bloomberg-mcp.ps1

Option B: uv MCP config

Use this shape if writing a config manually:

claude mcp add bloomberg -- uv run --project /path/to/bloomberg-mcp python /path/to/bloomberg-mcp/launcher.py

Or add to .mcp.json:

{
  "mcpServers": {
    "bloomberg": {
      "command": "uv",
      "args": ["run", "--project", "C:/path/to/bloomberg-mcp", "python", "C:/path/to/bloomberg-mcp/launcher.py"],
      "env": {
        "BLOOMBERG_MCP_HOME": "C:/path/to/bloomberg-mcp",
        "PYTHONUTF8": "1"
      }
    }
  }
}

Cursor / VS Code / LM Studio JSON shape:

{
  "bloomberg": {
    "command": "uv",
    "args": ["run", "--project", "C:/path/to/bloomberg-mcp", "python", "C:/path/to/bloomberg-mcp/launcher.py"],
    "env": {
      "BLOOMBERG_MCP_HOME": "C:/path/to/bloomberg-mcp",
      "PYTHONUTF8": "1"
    }
  }
}

Tip: The setup script resolves the full uv.exe path automatically. If writing config by hand, find it with where uv.

Option C: Manual install

cd bloomberg-mcp
pip install -r server/requirements.txt
pip install --index-url=https://blpapi.bloomberg.com/repository/releases/python/simple/ blpapi

Then configure with python directly:

{
  "command": "python",
  "args": ["C:/path/to/bloomberg-mcp/launcher.py"]
}

Tools

MCP Resources

The server exposes BQL reference documentation as MCP resources:

• bloomberg://references/index — navigation index

• bloomberg://references/{domain}/{file} — domain-specific reference

• bloomberg://tests/{file} — verified test queries

BQL Reference Domains

Critical BQL Syntax Rules

These rules are embedded in tool descriptions so any MCP client learns them automatically:

Project Structure

bloomberg-mcp/
├── pyproject.toml             # uv project config (auto-installs deps)
├── launcher.py                # Public MCP entrypoint / dependency bootstrapper
├── server/
│   ├── server.py              # Internal FastMCP implementation (12 tools + resources)
│   ├── bloomberg_client.py    # Unified xbbg data access (BQL in-process via blpapi)
│   ├── bql_builder.py         # BQL validation + template builder
│   ├── chart_engine.py        # Chart rendering helpers
│   ├── utils.py               # Helpers (status check, serialization)
│   └── requirements.txt
├── references/                # 17 BQL reference files
│   ├── _tree-index.md
│   ├── equity/
│   ├── fixed-income/
│   ├── credit/
│   ├── returns/
│   ├── curves/
│   ├── funds/
│   ├── functions/
│   └── securitized/
└── tests/                     # 27 verified .bql test queries

License

MIT