ibapi-mcp-server

# Interactive Brokers API FastMCP Server A server implementation for Interactive Brokers' API that allows LLMs to interact with your IB account using the Model Context Protocol (MCP). ## Overview This project creates a middleware server that connects to Interactive Brokers Gateway and exposes its functionality through the FastMCP framework. This allows LLMs like Claude to interact with your IB account, retrieve portfolio information, and potentially execute trades. ## Features - Connect to Interactive Brokers Gateway via the official IB API - Support multiple simultaneous client connections through FastMCP - Expose IB functionality as MCP tools and resources - Connection status monitoring - Error handling and logging ## Prerequisites - Python 3.11+ - Interactive Brokers Gateway installed and running - IB account with API access enabled ## Installation 1. Clone this repository: ``` git clone https://github.com/karimQuant/ibapi-mcp-server.git cd ibapi-mcp-server ``` 2. Install dependencies: ``` pip install -e . ``` ## Usage 1. Start your IB Gateway and log in 2. Run the server: a. Using stdio transport (default): ``` python server.py ``` b. Using SSE transport: ``` python server.py sse ``` c. Using SSE transport with custom port: ``` python server.py sse port=9000 ``` d. Using the FastMCP CLI: ``` fastmcp run server.py ``` e. For development with an interactive testing environment: ``` fastmcp dev server.py ``` 3. Connect client applications (like Claude Desktop) to the server ## API Documentation The FastMCP Server provides the following functionality: ### Available Tools - **get_portfolio_tool**: Retrieve your current portfolio positions and account summary ### Resources - **ibgateway://{host}/{port}**: Get the current status of the IB Gateway connection ## License MIT ## Contribution Contributions are welcome! Please feel free to submit a Pull Request.