Skip to content
MCP server

xbbg MCP

Local stdio MCP server giving coding agents bounded access to Bloomberg reference

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
1.8.1
Listing updated
today

Similar MCP servers

About xbbg MCP

xbbg MCP is an open-source 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 local stdio server that wraps Bloomberg request and response workflows, built on the xbbg-async engine. It is aimed at coding agents such as Claude Code and OpenCode that launch a local process and call tools over stdio.

The server exposes tools for reference data (bdp), historical data (bdh), bulk data (bds), intraday bars (bdib), BQL queries, search, field metadata, auction venue resolution and snapshots, entitlement checks, and delayed-data status. Every response is returned as bounded JSON with Arrow schema metadata, and environment variables control row, cell, string and byte limits.

Bloomberg runtime libraries and entitlements are not bundled. Users must supply their own authorized Bloomberg SDK or Python blpapi package and run it against a Terminal or B-PIPE session they are licensed for.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "xbbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/underloam/xbbg/releases/download/v1.8.1/xbbg-mcp-v1.8.1.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/underloam/xbbg/releases/download/v1.8.1/xbbg-mcp-v1.8.1.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/underloam/xbbg/releases/download/v1.8.1/xbbg-mcp-v1.8.1.mcpb"
      ]
    }
  }
}

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

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

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

{
  "mcpServers": {
    "xbbg-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/underloam/xbbg/releases/download/v1.8.1/xbbg-mcp-v1.8.1.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 Bloomberg request

What it does

Reference and historical data
Retrieves reference data, historical series, bulk fields and intraday bars through named tools.
Bounded structured output
Limits rows, cells, string sizes and final payload bytes, with truncation flags so agents can tell when results are partial.
Auction venue snapshots
Resolves equity tickers and ISINs to primary venues and reads auction and imbalance fields for them.
Entitlement and delay checks
Checks entitlement IDs returned by requests and reports whether a session receives delayed data.
Generic request path
Accepts raw service and operation requests for Bloomberg endpoints not covered by dedicated tools.
Configurable connection settings
Host, port, auth method, validation mode and result budgets are set through MCP-prefixed environment variables.

Good for

  • Letting a coding agent pull Bloomberg reference data into a local analysis script
  • Fetching historical prices or intraday bars for quantitative prototyping
  • Checking whether returned market data is delayed before using it
  • Resolving composite tickers to primary-exchange auction data
  • Running BQL queries from inside an agent session

Pricing

Open source

Open-source server; Bloomberg access requires the user's own Bloomberg agreement and entitlements.

xbbg MCP FAQ

Does the server include Bloomberg libraries or data?

No. The README states that release assets do not include Bloomberg SDK files, runtime or market data; users must provide their own authorized runtime locally.

Which transport does it use?

It runs as a local stdio MCP server, so the MCP client launches the binary as a child process.

Which clients are mentioned?

The README gives setup examples for Claude Code and OpenCode and mentions Claude Desktop as a host that captures its logs.

Does it send usage data anywhere?

The README's privacy section says it sends no telemetry and does not persist request data, credentials or responses to disk.

Is xbbg MCP free?

Yes. xbbg MCP is open source, so you can use and self-host it for free.

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/underloam/xbbg/releases/download/v1.8.1/xbbg-mcp-v1.8.1.mcpb

What are the best alternatives to xbbg MCP?

The closest alternatives to xbbg MCP are Bitquery MCP Server, bexio MCP by usefulapi, stocks-llm, Bsale MCP by usefulapi and Central Command.

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