{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_na2bt79bpupe","handle":"interactive-brokers-mcp-2","url":"https://wellknown.network/agents/interactive-brokers-mcp-2","links":{"self":"https://wellknown.network/agents/interactive-brokers-mcp-2/record.json","html":"https://wellknown.network/agents/interactive-brokers-mcp-2","markdown":"https://wellknown.network/agents/interactive-brokers-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/interactive-brokers-mcp-2","status":"https://wellknown.network/api/v1/agents/interactive-brokers-mcp-2/status","claim":"https://wellknown.network/agents/interactive-brokers-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/interactive-brokers-mcp-2/claim.json","badge":"https://wellknown.network/agents/interactive-brokers-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/interactive-brokers-mcp-2/history","tools":"https://wellknown.network/api/v1/agents/interactive-brokers-mcp-2/tools"},"ard":{"identifier":"urn:air::server:interactive-brokers-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"interactive-brokers-mcp","summary":"MCP server for Interactive Brokers Gateway — 7 tools for market data and account access via Claude","description":"# ibkr-mcp\n\nMCP server for Interactive Brokers Gateway — 7 tools for market data and account access via Claude.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_ibkr_market_data` | Historical OHLCV bars for any contract |\n| `get_ibkr_positions` | Current portfolio positions and P&L |\n| `get_ibkr_account` | Account summary (balances, margin, NAV) |\n| `get_ibkr_contract` | Contract lookup and details |\n| `get_ibkr_option_prices` | Option chain pricing |\n| `get_ibkr_snapshot` | Real-time quote snapshot |\n| `get_ibkr_status` | IBKR Gateway connection diagnostics |\n\n## Install\n\n```bash\npip install interactive-brokers-mcp\n```\n\n## Prerequisites\n\n- [IB Gateway](https://www.interactivebrokers.com/en/trading/ibgateway-stable.php) or TWS running\n- API access enabled in Gateway/TWS settings\n- Host/port/client ID matching your environment variables\n\n## Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `IBKR_GATEWAY_HOST` | `127.0.0.1` | Gateway hostname |\n| `IBKR_GATEWAY_PORT` | `7496` | Gateway port |\n| `IBKR_CLIENT_ID` | `1` | API client ID |\n| `IBKR_TIMEOUT` | `10` | Connection timeout (seconds) |\n| `IBKR_READONLY` | `false` | Read-only mode |\n| `IBKR_AUTHORIZED_ACCOUNTS` | | Comma-separated account whitelist |\n| `IBKR_CACHE_DIR` | | Optional cache directory override |\n\nThe package auto-loads `.env` from the package directory and parent.\n\n## Usage\n\n### Claude Code\n\n```bash\nclaude mcp add ibkr-mcp -- ibkr-mcp\n```\n\nOr in `~/.claude.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"ibkr-mcp\": {\n      \"type\": \"stdio\",\n      \"command\": \"ibkr-mcp\"\n    }\n  }\n}\n```\n\n### Standalone\n\n```bash\nibkr-mcp          # via installed entry point\npython -m ibkr.server   # via module\n```\n\n## License\n\nPolyForm Noncommercial 1.0.0","publisher":null,"homepage":"https://github.com/henrysouchien/ibkr-mcp","repository":"https://github.com/henrysouchien/ibkr-mcp","version":"0.2.10","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:interactive-brokers-mcp","type":"package_pypi","auth":null,"probeable":false,"listed":true}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"derived"},{"slug":"data.apis","name":"API Access","confidence":0.871,"provenance":"derived"},{"slug":"commerce.pricing","name":"Pricing & Quotes","confidence":0.779,"provenance":"derived"}],"categories":["commerce","data","finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"interactive-brokers-mcp","registry":"pypi","observedAt":"2026-11-09T11:26:20.534Z","publishedAt":"2026-09-16T13:38:07.957096Z","latestVersion":"0.2.10"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"interactive-brokers-mcp","url":"https://pypi.org/project/interactive-brokers-mcp/","firstSeenAt":"2026-09-09T22:21:47.747Z","fetchedAt":"2026-11-09T11:25:15.130Z","normalizedAt":"2026-11-09T11:25:15.130Z"}]},"firstSeenAt":"2026-09-09T22:21:47.747Z","updatedAt":"2026-11-09T11:26:20.534Z"}