プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

IBKR Portfolio Builder

作者:adwiteeymauriyaバージョン 0.1.4i★ 20iクラウドで動くリポジトリ ↗
レジストリ名io.github.adwiteeymauriya/ibkr-portfolio-builder-mcp

インストール方法

What it does

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

  • Connects クラウドで動く
  • Account or key Needs Authorization
  • Category 検索・AIの記憶

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

作者:google-research★ 35,6381 個の skill

Skill · 手順書

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

作者:BigBodyCobain★ 11,6051 個の skill

Skill · 手順書

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

作者:gosom★ 8,2361 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気16/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ3/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア19/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

IBKR Portfolio Builder をインストールして。https://mcp.popnx.com/i/adwiteeymauriya-ibkr-portfolio-builder-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · 質問内容は提供元のサーバー({ibkr_mcp_host})を通ります · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

IBKR Portfolio Builder のキーが必要です(提供元のサイトで作成) · アドレスに {…} の部分があり、先に自分の値に書き換える必要があります · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. IBKR Portfolio Builder に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前IBKR Portfolio Builder
    Remote MCP server URL · アドレスhttps://{ibkr_mcp_host}/mcp

    Request headers に、この名前と値を追加

    ヘッダー名Authorization
    値Bearer <ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  4. チャットで有効にする

    +ConnectorsIBKR Portfolio Builder

  5. 試してみる

    IBKR Portfolio Builder を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が IBKR Portfolio Builder を使っていると言うか、回答に IBKR Portfolio Builder のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ IBKR Portfolio Builder につなげません

IBKR Portfolio Builder は接続時に自分のキーが必要ですが、OpenAI のヘルプページは OAuth ログインしか説明しておらず、確認できたキー入力方法がありません

代わりにできること

A · IBKR Portfolio Builder につなげるアプリを使う

  • IBKR Portfolio Builder のキーが必要です(提供元のサイトで作成) · アドレスに {…} の部分があり、先に自分の値に書き換える必要があります · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
  • IBKR Portfolio Builder のキーが必要です(提供元のサイトで作成) · アドレスに {…} の部分があり、先に自分の値に書き換える必要があります
  • IBKR Portfolio Builder のキーが必要です(提供元のサイトで作成) · アドレスに {…} の部分があり、先に自分の値に書き換える必要があります
  • IBKR Portfolio Builder のキーが必要です(提供元のサイトで作成) · アドレスに {…} の部分があり、先に自分の値に書き換える必要があります

B · 検索・AIの記憶 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

IBKR Portfolio Builder のキーが必要です(提供元のサイトで作成) · アドレスに {…} の部分があり、先に自分の値に書き換える必要があります

  1. IBKR Portfolio Builder に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user ibkr-portfolio-builder 'https://{ibkr_mcp_host}/mcp' --header 'Authorization: Bearer your-value'

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Claude Code で /mcp と入力

    IBKR Portfolio Builder が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    IBKR Portfolio Builder を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が IBKR Portfolio Builder を使っていると言うか、回答に IBKR Portfolio Builder のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

IBKR Portfolio Builder のキーが必要です(提供元のサイトで作成) · アドレスに {…} の部分があり、先に自分の値に書き換える必要があります

  1. IBKR Portfolio Builder に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. Cursor の MCP 設定ファイルを開く

    ~/.cursor/mcp.json

    この設定を貼り付け、空いている値を入力して保存

    {
      "mcpServers": {
        "ibkr-portfolio-builder": {
          "url": "https://{ibkr_mcp_host}/mcp",
          "headers": {
            "Authorization": "Bearer your-value"
          }
        }
      }
    }
  3. キーを入力

    IBKR Portfolio Builder の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Cursor の AI チャットを Agent モードで開く

  5. 試してみる

    IBKR Portfolio Builder を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が IBKR Portfolio Builder を使っていると言うか、回答に IBKR Portfolio Builder のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

IBKR Portfolio Builder のキーが必要です(提供元のサイトで作成) · アドレスに {…} の部分があり、先に自分の値に書き換える必要があります

  1. IBKR Portfolio Builder に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  2. VS Code の MCP 設定ファイルを開く

    MCP: Open User Configuration

    この設定を貼り付け、空いている値を入力して保存

    {
      "servers": {
        "ibkr-portfolio-builder": {
          "type": "http",
          "url": "https://{ibkr_mcp_host}/mcp",
          "headers": {
            "Authorization": "Bearer your-value"
          }
        }
      }
    }
  3. キーを入力

    IBKR Portfolio Builder の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. VS Code の AI チャットを Agent モードで開く

  5. 試してみる

    IBKR Portfolio Builder を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が IBKR Portfolio Builder を使っていると言うか、回答に IBKR Portfolio Builder のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://{ibkr_mcp_host}/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?IBKR Portfolio Builder を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user ibkr-portfolio-builder 'https://{ibkr_mcp_host}/mcp' --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ibkr-portfolio-builder": {
      "url": "https://{ibkr_mcp_host}/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ibkr-portfolio-builder": {
      "type": "http",
      "url": "https://{ibkr_mcp_host}/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

自分で入力する値

  • Authorization 秘密 HTTP header
    Optional. Send 'Bearer ' for the bearer-auth path (skips the OAuth dance). Required if your deployment runs in AUTH_MODE=bearer. Leave blank to use OAuth (Claude.ai will trigger the login flow on con…

説明は英語の原文のままです。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
0.1.4
レジストリ公開日i
2026年6月8日
コードの最終更新i
2026年6月8日
最終確認
2026年11月19日
作者
adwiteeymauriya
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

すべてのアプリと長所・短所 →

できること

アドレスにあなた自身の値が必要なため、代わりにツール一覧を読み取ることはできません。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント adwiteeymauriya で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:5 か月前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    アドレスにあなた自身のアカウント情報が必要なため、代わりにチェックできません

  • – 対象外

    OAuthでサインイン

    アドレスにあなた自身のアカウント情報が必要なため、代わりにチェックできません

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/adwiteeymauriya-ibkr-portfolio-builder-mcp.svg)](https://mcp.popnx.com/en/servers/adwiteeymauriya-ibkr-portfolio-builder-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

検索・AIの記憶のほかのサーバーとの比較i

  • このカテゴリのほかの6447件のうち95%よりスターが多い
  • このカテゴリのほかの6447件のうち14%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6447件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

IBKR Portfolio Builderは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:Authorization

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は5 か月前、最新バージョン(0.1.4)がレジストリに届いたのは5 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

作者:every-app広く使われている★ 2.8万5 日前更新

クラウドで動く✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

作者:exa-labs広く使われている★ 52442 か月前更新

クラウドで動く✓ 提供元 · exa.aiPopNx チームが実際に試用

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

作者:MicrosoftDocs広く使われている★ 200012 か月前更新

クラウドで動く✓ 提供元 · microsoft.comPopNx チームが実際に試用

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

作者:proxysoul成長中★ 16282 か月前更新

クラウドで動く✓ empryo.com
似たものと比べる
これ
IBKR Portfolio Builder
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいはいはいいいえいいえ
基本チェック3/35/52/44/44/44/4
ライセンスMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

ibkr-portfolio-builder-mcp

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.

*Most ibkr-mcp servers expose individual lookup primitives — get_quote, get_position, place_order. This one exposes the research workflow: a typed catalog of 468 screeners across 16 categories tagged by strategy intent (value / growth / income / momentum / quality / events / …), per-scan applicable instruments, inverse-pair links, and live news/account access — so an LLM can do real top-down portfolio construction (pick sectors / strategies → run scans → cross-reference with news → narrow to candidates) instead of bottoms-up ticker fishing.*

Why this exists

I built this because the existing IBKR-MCP servers in the community treat IBKR as a "look-up-one-ticker" data source. That mirrors how most retail brokerage UIs work, but it's not how good portfolio construction actually happens.

A good top-down workflow looks like:

  1. Macro thesis ("rates are about to fall, dividend payers should re-rate") →
  2. Strategy intent ("show me income screens with quality bias on US large caps") →
  3. Screener composition (run dividend yield + ROE + low debt screens; intersect) →
  4. Event/news context ("any of these have earnings in the next two weeks? any negative analyst actions?") →
  5. Narrow candidate set ("five tickers, ranked by my criteria, ready for deeper diligence").

To do that with an LLM, the MCP server needs to expose the research vocabulary, not just the raw API. That's the gap this server fills:

  • A typed scan catalog — 468 IBKR scan codes across 16 categories (Fundamentals, Price Movement, Dividends, Options & Volatility, Events & Earnings, 52/26/13 Week High-Low, ESG, Bonds, …) auto-tagged with 28 strategy intent tags (value, growth, quality, income, momentum_up, momentum_down, analyst, technical, gap, volatility, events, leverage, efficiency, risk_adjusted, …). The LLM asks "what value scans exist for US stocks?" and gets a clean, filterable answer instead of trying to guess scan codes from training data.
  • 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.

It's still an early server. The IBKR API has plenty of restrictions on what a paper account can actually see (notably historical news entitlement). But the *catalog* and *workflow shape* are production-ready, and they're the load-bearing piece for an LLM-driven research loop.

Quick facts

  • Transport: Streamable HTTP at /mcp.
  • Auth: OAuth 2.1 (PKCE + RFC 7591 Dynamic Client Registration) AND/OR static bearer token. Selectable via AUTH_MODE.
  • Persistence: in-memory only today (sessions / DCR clients / OAuth tokens reset on container restart). Redis is on the roadmap — see below.
  • IBKR connection: ib-gateway (ghcr.io/gnzsnz/ib-gateway:stable) runs as a sibling service in this compose; paper account in read-only API mode by default.
  • Built on: FastMCP + ib_async.

Tools

Parity with IBKR's official MCP for the 9 read-only tools (skipping the two write/order-instruction tools — see roadmap), plus the 5 screener/news/catalog tools that are this server's reason for existing.

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.
ib_news_articleFetch a single article body by provider_code + article_id. ⚠️ may incur a per-article fee (Dow Jones in particular).

Note on order placement. IBKR's official MCP also exposes Create Order Instruction and Delete Order Instruction. This server intentionally does not — it runs ib-gateway in READ_ONLY_API=yes mode so even a misrouted tool call cannot place an order. Order execution belongs in a separate service with its own approval gate. See the roadmap for a possible "staged-only" instruction tool that would write to a local store without ever touching IBKR.

Authentication

AUTH_MODE selects which mechanisms the server accepts. The default is both.

ModeWhat's acceptedRequired env
oauthOAuth-issued tokens only. Required for Claude.ai custom connectors.LOGIN_PASSWORD
bearerA static Authorization: Bearer only. Skips the OAuth dance — best for CLI clients, Claude Code, your own scripts.STATIC_BEARER_TOKEN
both *(default)*Either OAuth tokens or the static bearer token.At least one of LOGIN_PASSWORD or STATIC_BEARER_TOKEN.

The OAuth endpoints (/authorize, /token, /register, /.well-known/*, /login) are always registered. In bearer mode they're inert — nothing in your README needs to point at them.

Generating secrets
uv run --no-project python -c "import secrets; print(secrets.token_urlsafe(48))"   # bearer token

uv run --no-project python -c "import secrets; print(secrets.token_urlsafe(48))" # session secret

Using the static bearer token
curl -X POST https://YOUR.DOMAIN/mcp \

-H "Authorization: Bearer $STATIC_BEARER_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Connecting from Claude.ai (OAuth)

Settings → Connectors → Add custom connector → URL: https://YOUR.DOMAIN/mcp → leave OAuth client id/secret blank (Claude.ai uses DCR). When Claude.ai opens the OAuth flow, you'll be prompted for LOGIN_PASSWORD.

Run

cp .env.example .env

edit .env: set TWS_USERID / TWS_PASSWORD (paper account), LOGIN_PASSWORD, STATIC_BEARER_TOKEN, PUBLIC_BASE_URL

docker compose up -d

By default this pulls the published multi-arch image from GitHub Container Registry: ghcr.io/adwiteeymauriya/ibkr-portfolio-builder-mcp:latest. To build locally instead (e.g. when iterating on the source), run docker compose build ibkr-mcp first.

ib-gateway takes ~60–90 s to finish IBKR login after first start. Tail logs with docker logs -f ibkr-mcp-gateway.

For local-only use (bearer-token clients, no Claude.ai) this is enough — http://localhost:8000/mcp is now serving. Claude.ai custom connectors require an HTTPS URL on the public internet, so a reverse proxy with TLS in front is needed.

Putting TLS in front for Claude.ai

Pick one. Both end with a working https://your-host/mcp and a valid cert.

Option 1 — Cloudflare Tunnel (no public IP, no port forwarding). Best if the server runs on a home network or a VM behind NAT. Cloudflare gives you a hostname and TLS for free; the tunnel daemon dials out from the server to Cloudflare's edge.

# One-time: install cloudflared, then

cloudflared tunnel login cloudflared tunnel create ibkr-mcp cloudflared tunnel route dns ibkr-mcp ibkr-mcp.your-domain.com

~/.cloudflared/config.yml:

tunnel: ibkr-mcp

credentials-file: /home/you/.cloudflared/ .json ingress:

  • hostname: ibkr-mcp.your-domain.com service: http://localhost:8000
  • service: http_status:404

Run with cloudflared tunnel run ibkr-mcp (or install as a systemd unit via cloudflared service install). Then set PUBLIC_BASE_URL=https://ibkr-mcp.your-domain.com in .env and docker compose restart ibkr-mcp.

Option 2 — Caddy reverse proxy with Let's Encrypt. Best if the server has a public IP and ports 80/443 open. Caddy fetches certs automatically.

Caddyfile:

ibkr-mcp.your-domain.com {

reverse_proxy localhost:8000 }

Run with caddy run (or install as a system service: sudo caddy start + a systemd unit). Same .env change as above.

In both cases PUBLIC_BASE_URL must match exactly the URL you give Claude.ai — Claude.ai validates the OAuth issuer against it.

Example LLM prompts (top-down workflow)

1. Discovery:

"List the strategies and categories available in ib_scan_catalog."

  1. Strategy intent: "Find me value scans for US stocks. Show me their inverse codes too."
  1. Composition: "Run LOW_PE_RATIO on STK.US.MAJOR with priceAbove $20 and avgVolumeAbove 1,000,000, top 30. Cross-reference with HIGH_RETURN_ON_EQUITY top 30. Show me overlap."
  1. Event context: "For the overlap list, check ib_news_for_symbol for any negative headlines in the last 7 days, and Events & Earnings scans for upcoming earnings within 14 days."
  1. Narrow: "Rank the survivors by liquidity and tell me which two you'd dig into next."

Roadmap

AreaItem
AuthRedis-backed sessions, DCR clients, OAuth tokens
AuthPer-token scopes (read-only, read-news, screener-only, ...)
InstrumentsOptions (chains, greeks, IV/price calc)
InstrumentsFutures (ContFuture, combos via Bag)
InstrumentsBonds (search + quote)
InstrumentsForex + crypto
ExchangesNon-US equity routings (EU, HK, JP, AU)
ExchangesCurrency-aware ib_account_summary

| Research | Reuters fundamentals (`reqF

冒頭だけを表示しています。続きはリポジトリで読めます