mcpField
I
Interactive Brokers API FastMCP Server

Interactive Brokers API FastMCP Server

Local
github.com/karimQuantDeveloper Tools4Updated 77w ago
Repository

About Interactive Brokers API FastMCP Server

Interactive Brokers API FastMCP Server connects Interactive Brokers Gateway to LLMs through FastMCP. It is intended for users who want MCP access to account portfolio data and Gateway connection status.

Key features

  1. 01Connect through the official IB API
  2. 02Support simultaneous client connections
  3. 03Expose tools and resources
  4. 04Monitor Gateway connection status
  5. 05Provide error handling and logging

Use cases

  1. 01Retrieve portfolio positions and account summary
  2. 02Check Interactive Brokers Gateway status

MCP support

Exposes Interactive Brokers functionality as MCP tools and resources, including a portfolio retrieval tool and a Gateway status resource.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
  1. 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.