Content
# IBKR MCP Server
This is an example MCP server that retrieves account positions from IBKR.
## Screenshot

## Prerequisites
* Node.js
* An IBKR account with API access enabled, a desktop running either IBKR Gateway or TWS
* MCPHost ([https://github.com/mark3labs/mcphost](https://github.com/mark3labs/mcphost))
* Ollama ([https://ollama.com/](https://ollama.com/))
## Installation
1. Clone this repository and install dependencies:
```bash
git clone https://github.com/ciri/ibkr-mcp-ts.git
cd ibkr-mcp-ts
npm install
```
2. Configure your IBKR connection:
* Edit the `server.ts` file to set the correct port for your IBKR TWS (7496) or IB Gateway (4001, default).
3. Set up MCPHost:
```bash
go install github.com/mark3labs/mcphost@latest
```
4. Configure Ollama:
```bash
ollama pull qwen2.5
ollama serve
```
## Running the Server
First, make sure that you are logged into IBKR TWS or IB Gateway.
Then, start MCPHost with the configuration file:
```bash
mcphost -m ollama:qwen2.5 --config ./config.json
```
## MCP Configuration
Add the following to your MCP configuration file (`config.json`):
```json
{
"mcpServers": {
...
"ibkr": {
"command": "node",
"args": ["/path/to/ibkr-mcp-ts/dist/server.js"],
"env": {}
}
}
}
```
**Note:** Replace `/path/to/ibkr-mcp-ts/dist/server.js` with the actual path to the `server.js` file.
## Disclaimer
This is an example implementation and may require further configuration and adjustments to work correctly in your environment. You probably want to try this with your paper trading account first or ensure you only allow read access to the API.
Connection Info
You Might Also Like
valuecell
Valuecell is a Python project for efficient data management.
hexstrike-ai
HexStrike AI is an AI-powered MCP cybersecurity automation platform with 150+ tools.
AP2
AP2 provides code samples and demos for the Agent Payments Protocol.
FNewsCrawler
FNewsCrawler is an MCP service providing real-time financial data for AI models.
QMT-MCP
QMT-MCP Modular Quantitative Trading Assistant
mcp-gemini-assistant
MCP Gemini - Coding Assistant for Claude Code