Canary MCP — Claude Code MCP server: IBKR account and risk data
Canary MCP — an MCP server that reads Interactive Brokers data: account balance, positions, limits, stress tests, decision history and stock lending fees.
MIT ★ 12 updated 2026-10-24
Open on GitHubWhat Canary MCP does
Canary MCP connects to a local IB Gateway or TWS session and gives an agent access to IBKR Pro account data. The server reads current positions grouped by underlying, checks configured limits (position size, premium budget, time value, margin), and generates a daily brief with alerts and protection or exercise candidates. Canary Edge compares past position changes with holding outcomes over 1, 5 and 20 sessions using Flex records and market history, reporting option P/L separately.
Requires IB Gateway 10.37+ or TWS with API access enabled, an IBKR Pro account, macOS or Linux (arm64/amd64). All MCP tools are read-only: no orders, settings changes or trade previews. Market data availability depends on IBKR subscriptions.
The server runs via canary mcp in stdio mode. For Claude Desktop, a bundle canary.mcpb ships with macOS and Linux binaries included.
What it helps with
- check account balance and open positions in IBKR
- see which positions breach configured size or margin limits
- review the daily brief with alerts and process exceptions
- compare past position-change outcomes with holding the prior position
- list high-fee lendable stocks outside a known exclusion list
Example prompts for the agent
- Show all positions grouped by underlying
- Which positions currently violate size or margin limits?
How to install Canary MCP
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Canary MCP
How do I install Canary MCP in Claude Code?
Download the script curl -fsSL https://raw.githubusercontent.com/osauer/canary/main/install.sh | sh, run canary status to confirm Gateway connection, then add canary mcp as a stdio server in your MCP configuration.
What does Canary MCP do?
Reads Interactive Brokers data through a local IB Gateway: account, positions, limits, stress tests and decision history. Generates a daily brief and checks the book against configured rules.
Can Canary MCP place orders?
No. All MCP tools are read-only. Order preview, modification and execution are unavailable through MCP in any build.