Interactive Brokers MCP

🚀 Interactive Brokers MCP Server

A Model Context Protocol (MCP) server that integrates with Interactive Brokers' trading platform, enabling AI assistants to interact with your IB account for market data retrieval, position checking, and trade placement.

🚀 Quick Start

Add this MCP server to your Cursor/Claude configuration:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"]
    }
  }
}

When you first use the server, a web browser window will automatically open for the Interactive Brokers OAuth authentication flow. Log in with your IB credentials to authorize the connection.

✨ Features

• Account Management: Get account information and balances
• Position Tracking: View current positions and P&L
• Market Data: Real-time market data for stocks and instruments
• Order Management: Place market, limit, and stop orders
• Order Monitoring: Check order status and execution details

📦 Installation

Prerequisites

No additional installations required! This package includes:

• Pre-configured IB Gateway for all platforms (Linux, macOS, Windows)
• Java Runtime Environment (JRE) for IB Gateway
• All necessary dependencies

You only need:

• Interactive Brokers account (paper or live trading)
• Node.js 18+ (for running the MCP server)

💻 Usage Examples

Headless Mode Configuration

For automated environments or when you prefer not to use a browser for authentication, you can enable headless mode by configuring it in your MCP server configuration:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password"
      }
    }
  }
}

In headless mode, the server will automatically authenticate using your credentials without opening a browser window. This is useful for:

• Automated trading systems
• Server environments without a display
• CI/CD pipelines
• Situations where browser interaction is not desired

Important: Even in headless mode, Interactive Brokers may still require two-factor authentication (2FA). When 2FA is triggered, the headless authentication will wait for you to complete the 2FA process through your configured method (mobile app, SMS, etc.) before proceeding.

To enable paper trading, add "IB_PAPER_TRADING": "true" to your environment variables:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password",
        "IB_PAPER_TRADING": "true"
      }
    }
  }
}

⚠️ Important Note

Store credentials securely and never commit them to version control. Consider using environment variable files or secure credential management systems.

📚 Documentation

Configuration Variables

Available MCP Tools

🔧 Technical Details

Security Notice

⚠️ Important Note

• Financial Risk: Trading involves substantial risk of loss. Always test with paper trading first.
• Security: This software handles sensitive financial data. Only run locally, never on public servers.
• No Warranty: This unofficial software comes with no warranties. Use at your own risk.
• Not Financial Advice: This tool is for automation only, not financial advice.

Troubleshooting

Authentication Problems:

• Use the web interface that opens automatically
• Complete any required two-factor authentication
• Try paper trading mode if live trading fails

Support

• This Server: Open an issue in this repository.

📄 License

MIT License - see LICENSE file for details.