ib-async-mcp

MCP (Model Context Protocol) server wrapping ib_async for Interactive Brokers API.

Features

• Connection Management: Connect/disconnect to TWS or IB Gateway
• Account Data: Account values, summary, portfolio, positions, P&L
• Contracts: Create and qualify contracts (stocks, options, futures, forex, crypto, etc.)
• Market Data: Real-time quotes and historical data
• Orders: Place, modify, cancel orders (market, limit, stop, stop-limit)
• Options: Option chains, implied volatility, option pricing
• Scanners: Market scanners with various criteria
• News: News providers and articles

Prerequisites

• Python 3.10+
• Interactive Brokers TWS or IB Gateway running with API enabled
• API port configured (default: 7497 for TWS, 4001 for Gateway)

Installation

cd ib-async-mcp
uv sync

Usage

Running the Server

uv run ib-async-mcp

MCP Configuration

Add to your MCP client configuration (e.g., .kiro/settings/mcp.json):

{
  "mcpServers": {
    "ib-async": {
      "command": "uv",
      "args": ["--directory", "/path/to/ib-async-mcp", "run", "ib-async-mcp"],
      "env": {}
    }
  }
}

Or using uvx (after publishing):

{
  "mcpServers": {
    "ib-async": {
      "command": "uvx",
      "args": ["ib-async-mcp"],
      "env": {}
    }
  }
}

Available Tools

Connection

• connect - Connect to TWS/Gateway
• disconnect - Disconnect
• is_connected - Check connection status

Account

• get_accounts - List managed accounts
• get_account_values - Account values (balance, margin, etc.)
• get_account_summary - Account summary
• get_portfolio - Portfolio with market values
• get_positions - All positions
• get_pnl - Profit and loss

Contracts

• create_contract - Create a contract
• qualify_contracts - Qualify contracts (fill conId)
• get_contract_details - Detailed contract info
• search_symbols - Search for symbols

Market Data

• get_market_data - Real-time snapshot
• get_historical_data - Historical bars
• get_head_timestamp - Earliest available data

Orders

• place_order - Place new order
• cancel_order - Cancel order
• cancel_all_orders - Cancel all orders
• get_open_orders - List open orders
• get_open_trades - List open trades
• get_executions - Execution reports
• get_fills - Order fills
• what_if_order - Check margin impact

Options

• get_option_chain - Option chain
• calculate_implied_volatility - Calculate IV
• calculate_option_price - Calculate option price

Scanners

• get_scanner_parameters - Available scanner params
• run_scanner - Run market scanner

News

• get_news_providers - List news providers
• get_news_article - Get article
• get_historical_news - Historical headlines

Utility

• get_current_time - TWS server time

Example Usage

# Connect first
connect(host="127.0.0.1", port=7497, client_id=1)

# Get account info
get_accounts()
get_portfolio()

# Get market data
get_market_data(contract_type="stock", symbol="AAPL")

# Get historical data
get_historical_data(
    contract_type="stock",
    symbol="SPY",
    duration="5 D",
    bar_size="1 hour"
)

# Place an order
place_order(
    contract_type="stock",
    symbol="AAPL",
    action="BUY",
    quantity=100,
    order_type="limit",
    limit_price=150.00
)

License

MIT

Disclaimer

This software is not affiliated with Interactive Brokers Group, Inc. Use at your own risk.