Skip to content
MCP server

xbbg MCP

Local MCP server giving coding agents request/response access to Bloomberg data

Runs locally
Install
Platforms
CLI, macOS, Linux
Runs
Locally
Version
1.4.12
Listing updated
1 day ago

Similar MCP servers

About xbbg MCP

xbbg MCP is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

The README describes xbbg-mcp as a stdio server that lets a coding agent launch a local process and query Bloomberg through tools such as reference data, historical data, bulk data, intraday bars and Bloomberg Query Language. It runs against a Bloomberg runtime already installed on the user's machine, so access is governed by that user's own Bloomberg agreements and entitlements.

Responses come back as bounded structured JSON with Arrow schema metadata, and row, cell, string and payload limits are configurable through environment variables. The project also includes auction venue resolution, auction snapshots, entitlement-ID checks and delayed-data status reporting for sessions that need to confirm what they are receiving.

The README names Claude Code and OpenCode as the intended clients and documents how to register the binary with each. It is aimed at developers and analysts who already hold Bloomberg access and want an agent to pull that data during a session.

Install

Run in a terminal

claude mcp add xbbg-mcp -- npx -y https://github.com/xbbg-org/xbbg/releases/download/v1.4.12/xbbg-mcp-v1.4.12.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "xbbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xbbg-org/xbbg/releases/download/v1.4.12/xbbg-mcp-v1.4.12.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "xbbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xbbg-org/xbbg/releases/download/v1.4.12/xbbg-mcp-v1.4.12.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "xbbg-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xbbg-org/xbbg/releases/download/v1.4.12/xbbg-mcp-v1.4.12.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "xbbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xbbg-org/xbbg/releases/download/v1.4.12/xbbg-mcp-v1.4.12.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "xbbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/xbbg-org/xbbg/releases/download/v1.4.12/xbbg-mcp-v1.4.12.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • XBBG_MCP_LIB_DIROptional directory containing Bloomberg runtime libraries. Leave unset to use BLPAPI_ROOT, an authorized vendored SDK layout, or Python blpapi fallback.
  • XBBG_MCP_HOSTBloomberg API host. Defaults to localhost.
  • XBBG_MCP_PORTBloomberg API port. Defaults to 8194.
  • XBBG_MCP_AUTH_METHODBloomberg auth method: none, user, app, userapp, dir, manual, or token.
  • XBBG_MCP_MAX_ROWSMaximum rows returned to the MCP client per response. Defaults to 500.
  • XBBG_MCP_MAX_CELLSMaximum data cells across returned rows and columns. Defaults to 50000.
  • XBBG_MCP_MAX_METADATA_PROPERTIESMaximum metadata properties retained per response. Defaults to 50000.
  • XBBG_MCP_MAX_METADATA_BYTESMaximum metadata bytes parsed or returned per response. Defaults to 65536.
  • XBBG_MCP_MAX_STRING_CHARSMaximum characters per string value returned to the MCP client. Defaults to 2048.
  • XBBG_MCP_MAX_STRING_BYTESMaximum UTF-8 bytes per string value, including a truncation marker. Defaults to 8192; minimum 3.
  • XBBG_MCP_MAX_RESULT_BYTESMaximum compact-JSON bytes in the structured result, including diagnostics. Defaults to 1048576; minimum 2048.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

bdp
Reference data
bdh
Historical data
bds
Bulk data
bdib
Intraday bars
bql
Bloomberg Query Language
bsrch
Bloomberg search
bflds
Field metadata lookup
resolve_venues
Resolve equity and preferred inputs to auction venues
auction_snapshot
Primary-venue auction and imbalance reference data
check_entitlements
Entitlement-ID check for a Bloomberg service
delay_status
Per-ticker delayed or real-time status
request
Generic raw or custom request path

What it does

Reference and historical data
Tools bdp, bdh, bds and bdib return reference fields, time series, bulk data and intraday bars.
Bloomberg Query Language support
A bql tool and a generic request path cover BQL expressions and other raw service operations.
Bounded structured output
Row, cell, string, metadata and total payload limits keep responses within configurable size.
Auction venue and snapshot tools
resolve_venues maps equities to validated auction venues and auction_snapshot reads imbalance and quote fields.
Entitlement and delay checks
check_entitlements and delay_status report entitlement IDs and whether a session receives delayed data.

Good for

  • Pulling historical prices or reference fields into a coding agent's analysis script
  • Checking whether a Bloomberg session is receiving delayed or real-time data before using results
  • Validating which entitlement IDs a returned dataset depends on
  • Running BQL queries from an agent session on a licensed workstation

xbbg MCP FAQ

Does it include Bloomberg data or a Bloomberg runtime?

No. The README says release assets do not include Bloomberg SDK files or runtime, which must be provided locally under the user's own authorization.

Which MCP clients does the README mention?

It names Claude Code and OpenCode and gives configuration examples for both, and notes an MCPB package for Claude Desktop.

Does the server send telemetry anywhere?

The README's privacy section states that it does not send telemetry or usage data to third parties and that tool calls are forwarded only to the configured Bloomberg endpoint.

Which operating systems are supported?

The README lists macOS arm64 and Linux amd64 for the convenience installer, and the MCPB package also covers Windows amd64.

How do I add xbbg MCP to Claude Code?

Run this command in your terminal: claude mcp add xbbg-mcp -- npx -y https://github.com/xbbg-org/xbbg/releases/download/v1.4.12/xbbg-mcp-v1.4.12.mcpb

What are the best alternatives to xbbg MCP?

The closest alternatives to xbbg MCP are SEC EDGAR (sec-api.dev), Bitquery MCP Server, Bitcoin Data Labs MCP, BankRegReports and GoldBean MCP Server.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers