Canary MCP
Read-only MCP tools for Interactive Brokers accounts, run locally beside IB Gateway
- Pricing
- Open source
- Platforms
- macOS, Linux, CLI
- Runs
- Locally
- Version
- 3.38.0
- Listing updated
- 3 days ago
About Canary MCP
Canary MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Canary is built around a local daemon that holds your IBKR connection, a written risk policy and an order journal. The MCP server is one of several ways to read the same figures; the CLI prints them as JSON and a paired phone app shows them too.
Every MCP tool is read-only: the server has no order or preview tool in any build, so an assistant such as Claude Desktop can ask about positions, exposure, market regime, stress and reporting but cannot place, change or cancel anything. Figures carry their source and age, and data Canary cannot confirm is reported as missing rather than shown as zero.
It needs an IBKR Pro account and IB Gateway or TWS running on your Mac or Linux machine with the API enabled. There is no Windows build; the author suggests WSL. Releases are signed, MIT-licensed and the site says there is no telemetry.
Install
Run in a terminal
claude mcp add canary -- npx -y https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"canary": {
"command": "npx",
"args": [
"-y",
"https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"canary": {
"command": "npx",
"args": [
"-y",
"https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"canary": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"canary": {
"command": "npx",
"args": [
"-y",
"https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"canary": {
"command": "npx",
"args": [
"-y",
"https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
]
}
}
}What it does
- Read-only by design
- The MCP server has no order or preview tool, so agents cannot trade through it.
- Positions and exposure
- Shows holdings and exposure by underlying, reconciled against broker statements.
- Risk rule checks
- Runs twenty discipline checks against limits you set and names those your positions breach.
- Canary Edge
- Shows what price did 1, 5 and 20 sessions after your past stock and ETF trades.
- Labelled gaps
- Stale or missing data is marked as such instead of being filled in.
- Claude Desktop bundle
- Installs through a one-click .mcpb bundle, or run `canary mcp` from any MCP host.
Good for
- Ask Claude what needs attention in your IBKR account today
- Review exposure by underlying before the market opens
- Check which risk rules your positions currently breach
- Script JSON portfolio readings from the CLI or a Go program
Pricing
Open source
MIT licence; free
Prices change. Check osauer.dev before you buy.
Canary MCP FAQ
Can an AI agent place trades through the MCP server?
No. The MCP server has no order or preview tool in any build; the separate opt-in trading binary sends orders only through a gated CLI path.
What do I need to run it?
An IBKR Pro account, IB Gateway 10.37+ or TWS with API socket access, and macOS or Linux on arm64 or amd64.
Does it run on a server?
No. It runs beside your IB Gateway or TWS on your own machine.
What licence is it under?
MIT.
Is Canary MCP free?
Yes. Canary MCP is open source, so you can use and self-host it for free.
How do I add Canary MCP to Claude Code?
Run this command in your terminal: claude mcp add canary -- npx -y https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb
What are the best alternatives to Canary MCP?
The closest alternatives to Canary MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to Canary MCP

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government