# Canary MCP

> Canary MCP is an open-source MCP server for finance and payments. Read-only MCP tools for Interactive Brokers accounts, run locally beside IB Gateway. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Website:** https://osauer.dev/canary/
- **Repository:** https://github.com/osauer/canary
- **MCP Registry name:** io.github.osauer/canary
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add canary -- npx -y https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "canary": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "canary": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "canary": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "canary": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "canary": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/osauer/canary/releases/download/v3.38.0/canary-v3.38.0.mcpb"
      ]
    }
  }
}
```

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/canary-mcp
