xbbg MCP
Local MCP server giving coding agents request/response access to Bloomberg data
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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.
