Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

IBKR Portfolio Builder

von adwiteeymauriyaVersion 0.1.4i★ 20iLäuft in der CloudRepository ↗
Name in der Registryio.github.adwiteeymauriya/ibkr-portfolio-builder-mcp

So installierst du es

What it does

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

  • Connects Läuft in der Cloud
  • Account or key Needs Authorization
  • Category Suche & KI-Gedächtnis

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

timesfm

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

von google-research★ 35.6381 Skills

Skill · Anleitung

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…

von BigBodyCobain★ 11.6051 Skills

Skill · Anleitung

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

von gosom★ 8.2361 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit16/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität3/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert19/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte IBKR Portfolio Builder. Folge https://mcp.popnx.com/i/adwiteeymauriya-ibkr-portfolio-builder-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters ({ibkr_mcp_host}) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von IBKR Portfolio Builder (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei IBKR Portfolio Builder registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameIBKR Portfolio Builder
    Remote MCP server URL · Adressehttps://{ibkr_mcp_host}/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameAuthorization
    WertBearer <Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

    +ConnectorsIBKR Portfolio Builder

  5. Ausprobieren

    Nutze IBKR Portfolio Builder und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es IBKR Portfolio Builder nutzt, oder ein Werkzeug von IBKR Portfolio Builder in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann IBKR Portfolio Builder noch nicht verbinden

IBKR Portfolio Builder braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die IBKR Portfolio Builder verbinden kann

  • Du brauchst einen Schlüssel von IBKR Portfolio Builder (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von IBKR Portfolio Builder (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt
  • Du brauchst einen Schlüssel von IBKR Portfolio Builder (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt
  • Du brauchst einen Schlüssel von IBKR Portfolio Builder (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt

B · Andere in Suche & KI-Gedächtnis, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von IBKR Portfolio Builder (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt

  1. Bei IBKR Portfolio Builder registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

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

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    IBKR Portfolio Builder sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze IBKR Portfolio Builder und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es IBKR Portfolio Builder nutzt, oder ein Werkzeug von IBKR Portfolio Builder in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von IBKR Portfolio Builder (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt

  1. Bei IBKR Portfolio Builder registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. MCP-Einstellungsdatei von Cursor öffnen

    ~/.cursor/mcp.json

    Diese Einstellungen einfügen, leere Werte ausfüllen und speichern

    {
      "mcpServers": {
        "ibkr-portfolio-builder": {
          "url": "https://{ibkr_mcp_host}/mcp",
          "headers": {
            "Authorization": "Bearer your-value"
          }
        }
      }
    }
  3. Schlüssel eintragen

    In den Einstellungen von IBKR Portfolio Builder ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze IBKR Portfolio Builder und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es IBKR Portfolio Builder nutzt, oder ein Werkzeug von IBKR Portfolio Builder in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von IBKR Portfolio Builder (auf der Seite des Anbieters erstellen) · Die Adresse enthält {…}-Teile, die du erst durch deine eigenen ersetzt

  1. Bei IBKR Portfolio Builder registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. MCP-Einstellungsdatei von VS Code öffnen

    MCP: Open User Configuration

    Diese Einstellungen einfügen, leere Werte ausfüllen und speichern

    {
      "servers": {
        "ibkr-portfolio-builder": {
          "type": "http",
          "url": "https://{ibkr_mcp_host}/mcp",
          "headers": {
            "Authorization": "Bearer your-value"
          }
        }
      }
    }
  3. Schlüssel eintragen

    In den Einstellungen von IBKR Portfolio Builder ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze IBKR Portfolio Builder und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es IBKR Portfolio Builder nutzt, oder ein Werkzeug von IBKR Portfolio Builder in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://{ibkr_mcp_host}/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die IBKR Portfolio Builder nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das 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"
      }
    }
  }
}

Werte, die du selbst einträgst

  • Authorization geheim 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…

Die Beschreibungen sind noch im englischen Original.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
0.1.4
In der Registry veröffentlichti
8. Juni 2026
Code zuletzt geänderti
8. Juni 2026
Zuletzt geprüft
19. Nov. 2026
Entwickler
adwiteeymauriya
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Die Adresse braucht deine eigenen Werte, deshalb können wir die Tool-Liste nicht für dich lesen.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto adwiteeymauriya bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 5 Monaten

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Die Adresse braucht Werte aus deinem eigenen Konto, deshalb können wir sie nicht für dich prüfen

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Die Adresse braucht Werte aus deinem eigenen Konto, deshalb können wir sie nicht für dich prüfen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![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)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Suche & KI-Gedächtnisi

  • Mehr Sterne als 95 % der anderen 6430 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 14 % der anderen 6430 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 6430 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist IBKR Portfolio Builder sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: Authorization

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 5 Monaten geändert, und die neueste Version (0.1.4) kam vor 5 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

OpenSEO

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

von every-appWeit verbreitet★ 28.285Aktualisiert vor 5 Tagen

Läuft in der Cloud✓ everyapp.com

Exa

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

von exa-labsWeit verbreitet★ 5244Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · exa.aiVom PopNx-Team ausprobiert

Microsoft Learn MCP

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

von MicrosoftDocsWeit verbreitet★ 1997Aktualisiert vor 12 Monaten

Läuft in der Cloud✓ vom Dienst · microsoft.comVom PopNx-Team ausprobiert

Docs

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

von proxysoulWachsend★ 1626Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ empryo.com

COTAL actions (cotal.ai)

cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls

von Cotal-AIWachsend★ 401Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · cotal.ai
Im Vergleich mit ähnlichen
Dieser
IBKR Portfolio Builder
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaJaJaNeinNein
Basisprüfungen3/35/52/44/44/44/4
LizenzMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Nur der Anfang wird gezeigt; den Rest findest du im Repo