IBKR Portfolio Builder MCP Server

Top-down IBKR research: 468 typed screeners tagged by strategy intent, news, account access.

Local serverstdioPython

What is the IBKR Portfolio Builder MCP Server?

Top-down IBKR research: 468 typed screeners tagged by strategy intent, news, account access.

What you get

A remote MCP server for top-down portfolio construction with Interactive Brokers. Built to be used as a Claude.ai custom connector, Claude Code MCP, or any HTTP MCP client.

  • Inverse pair links — — every HIGH_X ↔ LOW_X and X_ASC ↔ X_DESC pair is precomputed, so the LLM can flip polarity ("what's the opposite of LOW_PE_RATIO?") without guessing
  • Per-scan instrument map — — the catalog knows which scan applies to STK, ETF, OPT, BOND, etc. The LLM stops sending Refinitiv scans to bond instruments and getting empty results
  • Filter catalog — — separate typed map of the numeric filters (priceAbove, peRatioBelow, divYieldAbove, growthRateAbove, avgVolumeAbove, marketCapAbove, …) grouped by category, with per-instrument applicability notes
  • News + screeners in one tool surface — — same connector, same auth, same conversation. The LLM can intersect a scan result with recent headlines or upcoming earnings without context-switching
  • Two auth modes — — full OAuth 2.1 (DCR + PKCE + well-knowns) for Claude.ai custom connectors, plus a static bearer token for everything else. Same server, same tools

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
ib_account_summaryNetLiquidation / BuyingPower / TotalCashValue / AvailableFunds / UnrealizedPnL for the connected paper or live account.
ib_positionsOpen positions across managed accounts, with quantity / avg cost / mark-to-market / unrealized PnL.
ib_open_ordersCurrently working orders with status, filled / remaining quantity, average fill price.
ib_tradesRecent executed fills (days_back window, IBKR caps history ~7 days).
ib_price_snapshotCurrent bid / ask / last / high / low / volume for a US stock. Surfaces IBKR market-data restriction messages clearly.
ib_price_historyOHLCV bars for any duration / bar size (1 day, 1 hour, 5 mins, ...). Always works regardless of market-data subscription.
ib_search_contractsFuzzy-search IBKR's contract database by name / partial ticker.
ib_contract_detailsFull contract metadata — long_name, industry, category, subcategory, trading hours, valid exchanges. **The hook for sector-aware top-down screening.**
ib_scan_catalogThe 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_catalogFilter parameter codes grouped by category (price, volume, market_cap, fundamentals, technical, options), with an instrument applicability note.
ib_screener_codesSubstring search over the raw scan-parameters.xml codes (legacy / fallback). Useful for newer vendor codes not yet in the curated catalog.
ib_screenerRun an IBKR scan — pass scan_code, instrument, location, optional price / volume filters. Returns rank + ticker + exchange.
ib_news_providersList subscribed IBKR news providers (Briefing.com, Dow Jones, etc.).
ib_news_for_symbolFetch headlines for a US stock across all subscribed providers. Headlines only; surfaces a clear notice field when the account lacks historical-news entitlement.

Configuration

VariableDescriptionRequired
STATIC_BEARER_TOKENCredential the server authenticates with.Yes
PUBLIC_BASE_URLEndpoint or connection string the server talks to.Yes
TUNNEL_IDConfiguration value read at startup.Optional

Example prompts to try

  • “Use IBKR Portfolio Builder to ib account summary.”
  • “Use IBKR Portfolio Builder to ib positions.”
  • “Use IBKR Portfolio Builder to ib open orders.”

Frequently asked questions

Top-down IBKR research: 468 typed screeners tagged by strategy intent, news, account access. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.