Skip to main content
MCP server CX Codex

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 GitHub

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

Similar MCP servers

All MCP servers for Finance and business →

Project sponsors

Companies that keep this analytics open