IBKR MCP

MCP server for Interactive Brokers via IB Gateway on Windows. Runs in Docker and connects to IB Gateway on the host through host.docker.internal.

Features

• Live account (port 4001): read positions, quotes, option chains, day-trade status

• Paper account (port 4002): same reads plus place/cancel stock and option orders

Related MCP server: ib-async-mcp

Quick start

1. Configure IB Gateway API (see SETUP_GUIDE.md)

2. Install Python deps for local dev:

   pip install -e ".[dev]"

3. Install Cursor launchers:

   .\scripts\Install-IbkrMcpLaunchers.ps1

4. Add ibkr-live and/or ibkr-paper to Claude Desktop MCP config (Store app path below)

5. Restart Claude Desktop, start IB Gateway, then use the MCP tools in chat

Claude config (Microsoft Store): C:\Users\rodri\AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

Local run (no Docker)

set IBKR_HOST=127.0.0.1
set IBKR_PORT=4002
set IBKR_TRADING_ENABLED=true
python -m ibkr_mcp.server

Dev container

Open the repo in a dev container (.devcontainer/devcontainer.json). The container uses host.docker.internal to reach IB Gateway on Windows.

Tools

Stack

• Python 3.12

• mcp (FastMCP, stdio)

• ib_async

Tests

pytest