# xbbg MCP

> xbbg MCP is an open-source MCP server for finance and payments. Local stdio MCP server giving coding agents bounded access to Bloomberg reference. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Repository:** https://github.com/underloam/xbbg/tree/HEAD/apps/xbbg-mcp
- **MCP Registry name:** io.github.underloam/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 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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

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

## Alternatives

- [Bitquery MCP Server](https://ai-powered.com/mcp/bitquery-mcp-server): Bitquery MCP Server is a paid MCP server for finance and payments.
- [bexio MCP by usefulapi](https://ai-powered.com/mcp/bexio-mcp-by-usefulapi): bexio MCP by usefulapi is a freemium MCP server for finance and payments.
- [stocks-llm](https://ai-powered.com/mcp/stocks-llm): stocks-llm is a free MCP server for finance and payments.
- [Bsale MCP by usefulapi](https://ai-powered.com/mcp/bsale-mcp-by-usefulapi): Bsale MCP by usefulapi is a freemium MCP server for finance and payments.
- [Central Command](https://ai-powered.com/mcp/central-command): Central Command is a freemium 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.
- [Stock Bloc](https://ai-powered.com/mcp/stock-bloc): Stock Bloc is a paid MCP server for finance and payments.
- [Canary MCP](https://ai-powered.com/mcp/canary-mcp): Canary MCP is an open-source MCP server for finance and payments.

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