ib-mcp

[](https://github.com/Hellek1/ib-mcp/actions/workflows/ci.yml)

Lightweight Model Context Protocol (MCP) server exposing read-only Interactive Brokers data (contracts, historical data, fundamentals, news, portfolio, account) via the asynchronous `ib_async` library and `FastMCP`. Ideal for feeding financial data into LLM workflows and autonomous agents while keeping trading disabled.

This directory contains an MCP (Model Context Protocol) server that wraps the ib_async library to allow LLMs to interact with Interactive Brokers data.

The MCP server provides the following tools for LLM interaction:

• lookup_contract: Look up contract details by ticker symbol and optional exchange/currency
• ticker_to_conid: Convert ticker symbol to contract ID (conid)

• get_historical_data: Retrieve historical market data with configurable duration, bar size, and data type

• get_news: Retrieve current news articles for a contract
• get_historical_news: Retrieve historical news articles within a date range

• get_fundamental_data: Retrieve fundamental data including financial summaries, ownership, financial statements, and more

• get_portfolio: Retrieve portfolio positions and details
• get_account_summary: Retrieve account summary information
• get_positions: Retrieve current positions

1. Interactive Brokers Account: You need an active IB account
2. IB Gateway or TWS: Download and install either:

• IB Gateway (Stable) - Recommended for API-only use
• [IB Gateway (Latest)](https://www.interactiv