Ibkr Portfolio Builder Mcp

finance MCP Server

Remote MCP server for top-down portfolio construction with Interactive Brokers typed catalog of 468 IBKR screeners tagged by strategy intent (value/growth/income/momentum/quality), news, live account access. OAuth + static bearer auth. Works with Claude.ai custom connectors, Claude Code, and any HTTP MCP client.

VerifiedReviewed
financefinance
5 views16 stars2 forksMIT

Why This Matters

Discovered via github-seeds:mcp-hot and last synced 3mo ago.

VerifiedReviewed
Source
github-seeds:mcp-hot
Stars
16
Last synced
3mo ago
Install
Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions
25
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (25)

ib_open_orders

Currently working orders with status, filled / remaining quantity, average fill price.

ib_price_snapshot

Current bid / ask / last / high / low / volume for a US stock. Surfaces IBKR market-data restriction messages clearly.

ib_trades

Recent executed fills (`days_back` window, IBKR caps history ~7 days).

Tool

What it does

ib_account_summary

NetLiquidation / BuyingPower / TotalCashValue / AvailableFunds / UnrealizedPnL for the connected paper or live account.

ib_contract_details

Full contract metadata — `long_name`, `industry`, `category`, `subcategory`, trading hours, valid exchanges. **The hook for sector-aware top-down screening.**

ib_news_article

Fetch a single article body by `provider_code` + `article_id`. ⚠️ may incur a per-article fee (Dow Jones in particular).

Instruments

Forex + crypto

ib_positions

Open positions across managed accounts, with quantity / avg cost / mark-to-market / unrealized PnL.

ib_price_history

OHLCV bars for any duration / bar size (`1 day`, `1 hour`, `5 mins`, ...). Always works regardless of market-data subscription.

ib_news_providers

List subscribed IBKR news providers (Briefing.com, Dow Jones, etc.).

ib_search_contracts

Fuzzy-search IBKR's contract database by name / partial ticker.

ib_news_for_symbol

Fetch headlines for a US stock across all subscribed providers. Headlines only; surfaces a clear `notice` field when the account lacks historical-news entitlement.

ib_scan_catalog

The typed scan catalog. Filter by `category`, `strategy`, `instrument`, free-text `query`; optionally return the full list of available categories + strategies via `list_meta=true`.

ib_filter_catalog

Filter parameter codes grouped by category (`price`, `volume`, `market_cap`, `fundamentals`, `technical`, `options`), with an instrument applicability note.

oauth

OAuth-issued tokens only. Required for Claude.ai custom connectors.

ib_screener_codes

Substring search over the raw `scan-parameters.xml` codes (legacy / fallback). Useful for newer vendor codes not yet in the curated catalog.

ib_screener

Run an IBKR scan — pass `scan_code`, `instrument`, `location`, optional price / volume filters. Returns rank + ticker + exchange.

Area

Item

Exchanges

Currency-aware `ib_account_summary`

Mode

What's accepted

bearer

A static `Authorization: Bearer <token>` only. Skips the OAuth dance — best for CLI clients, Claude Code, your own scripts.

Research

Broader `ib_news_search`

Auth

Per-token scopes (`read-only`, `read-news`, `screener-only`, ...)

Risk

Local staged-instruction tools (no IBKR write)