# xbbg MCP

> xbbg MCP is an MCP server for finance and payments. Local MCP server giving coding agents request/response access to Bloomberg data. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/xbbg-org/xbbg/tree/HEAD/apps/xbbg-mcp
- **MCP Registry name:** io.github.xbbg-org/xbbg-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [SEC EDGAR (sec-api.dev)](https://ai-powered.com/mcp/sec-edgar-sec-api-dev): SEC EDGAR (sec-api.dev) is a freemium MCP server for legal and government.
- [Bitquery MCP Server](https://ai-powered.com/mcp/bitquery-mcp-server): Bitquery MCP Server is a paid MCP server for finance and payments.
- [Bitcoin Data Labs MCP](https://ai-powered.com/mcp/bitcoin-data-labs-mcp): Bitcoin Data Labs MCP is an open-source MCP server for finance and payments.
- [BankRegReports](https://ai-powered.com/mcp/bankregreports): BankRegReports is a freemium MCP server for finance and payments.
- [GoldBean MCP Server](https://ai-powered.com/mcp/goldbean-mcp-server-2): GoldBean MCP Server is a freemium MCP server for finance and payments.
- [BitCLI](https://ai-powered.com/mcp/bitcli): BitCLI is a paid MCP server for finance and payments.
- [Stock Bloc](https://ai-powered.com/mcp/stock-bloc): Stock Bloc is a paid MCP server for finance and payments.
- [Market Data: Options, Screeners, Economic Calendar (Yugenox)](https://ai-powered.com/mcp/market-data-options-screeners-economic-calendar-yugenox): Market Data: Options, Screeners, Economic Calendar (Yugenox) is a paid MCP server for productivity.

---
Source: https://ai-powered.com/mcp/xbbg-mcp-2
