Skip to content
MCP server

Canary MCP

Read-only MCP tools for Interactive Brokers accounts, run locally beside IB Gateway

Runs locallyStatus and history
Install
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government