Blpapi MCP

🚀 BLPAPI-MCP

An MCP server that provides financial data from Bloomberg's blpapi.

⚠️ Important Note

To run BLPAPI-MCP, you need to install and open the Bloomberg Terminal (BBComm must be accessible).

🚀 Quick Start

📦 Installation

Using UV

uv add git+https://github.com/djsamseng/blpapi-mcp

🚀 Running the MCP Server

uv run blpapi-mcp --sse --host 127.0.0.1 --port 8000

💻 Usage Examples

Using blpapi-cmp from Capsule

• For a project: Create a .cursor/mcp.json file in the project directory.
• Globally: Create a ~/.cursor/mcp.json file.
• Replace the host and port of the MCP server with the information of the server you ran above.

{
  "mcpServers": {
    "server-name": {
      "url": "http://127.0.0.1:8000/sse"
    }
  }
}

Using blpapi-mcp from Claude Code

• Replace the URL with the information of the MCP server you ran above.

claud mcp add --transport sse blpapi-mcp http://127.0.0.1:8000/sse

• Remote host support for Claude Desktop is still under development.

Using blpapi-mcp from Aider

• Pull request pending.

🔧 Development

Requirements

1. Install UV

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone this repository

git clone https://github.com/djsamseng/blpapi-mcp

3. Set up a virtual environment

uv venv
source .venv/bin/activate

4. Run the MCP server

uv run blpapi-mcp --sse --host 127.0.0.1 --port 8000

5. Run a test client that starts its own stdio mode server

uv run examples/clients/blp_stdio_client.py

6. Run a test client that uses an existing running sse server

uv run examples/clients/blp_sse_client.py --host http://127.0.0.1 --port 8000

📄 License

This project is not affiliated with Bloomberg Finance L.P. The use of the Bloomberg name here only describes the purpose of this package.