Trading 212 MCP-Server

Sicherer Zugriff auf die Trading 212 Public API für Claude via MCP

Erstellt mit:

Projektübersicht

Dieses Projekt stellt die Funktionen der Trading 212 Public API als MCP-Tools bereit, sodass Claude Desktop sicher Konten-, Markt-, Auftrags-, Historien- und Pie-Daten abfragen kann. Es richtet sich an Benutzer, die einen natürlichsprachlichen Zugriff auf ihre Portfolio-Workflows wünschen, ohne eine eigene Benutzeroberfläche erstellen zu müssen. Der Hauptvorteil liegt in einer modularen, funktionsbasierten TypeScript-Architektur mit strukturierten Fehlern, strenger Umgebungshandhabung und einer Tool-First-MCP-Integration.

Hauptfunktionen

• Claude-Ready MCP-Tools - Nutzen Sie Trading 212-Operationen direkt aus Claude Desktop über MCP.

• Public API-kompatible Authentifizierung - Unterstützt Trading 212 Basic Auth mit API-Key + API-Secret.

• Vollständige Pie-Abdeckung - Beinhaltet Operationen zum Auflisten, Abrufen nach ID, Erstellen, Aktualisieren, Duplizieren und Löschen von Pies.

• Auftrags-Workflows enthalten - Ausstehende Aufträge, Auftragsdetails, Platzieren/Stornieren von Limit-, Markt-, Stop- und Stop-Limit-Aufträgen.

• Historie + Export-Operationen - Cursor-basierte historische Aufträge, Dividenden, Transaktionen sowie Endpunkte für CSV-Exportanfragen/-listen.

• Typisiertes Fehlermodell - Konsistente Fehlerbehandlung für Authentifizierung, Validierung, Ratenbegrenzung, Nicht-gefunden-Fehler und API-Fehler.

Quick Start Demo

Lokal ausführen und dann die Tools mit dem MCP Inspector untersuchen:

npx @modelcontextprotocol/inspector

Für den stdio-Modus konfigurieren Sie den Inspector-Befehl wie folgt:

bun run src/server.ts

Tech-Stack

• Sprache: TypeScript (Strict Mode)

• Runtime: Bun 1.x (kompatibel mit Node.js 18+)

• MCP: @modelcontextprotocol/sdk

• Validierung/Schema: zod

• Konfiguration: dotenv

• Tests: Bun Test-Runner (bun test src)

Installation & Einrichtung

Voraussetzungen

• Bun 1.0+

• Node.js 18+

• Trading 212 Public API-Anmeldedaten (TRADING212_API_KEY, TRADING212_API_SECRET)

• Claude Desktop (für MCP-Integration)

Einrichtung

1. Repository klonen

   git clone https://github.com/razeevascx/212mcp.git

2. Zum Projekt navigieren

   cd 212mcp

3. Abhängigkeiten installieren

   bun install

4. Umgebung konfigurieren

   cp .env.example .env

5. Anmeldedaten in .env setzen

   TRADING212_API_KEY=your_api_key_here
   TRADING212_API_SECRET=your_api_secret_here
   ENVIRONMENT=live
   TRANSPORT=stdio
   LOG_LEVEL=info
   DEBUG=false

6. Projekt bauen

   bun run build

7. Server starten

   bun run start

Überprüfung

• Sie sollten Trading 212 MCP Server running in der Terminalausgabe sehen.

• Öffnen Sie in Claude Desktop die MCP-Tools und bestätigen Sie, dass die Trading 212-Tools aufgelistet sind.

Claude Desktop-Konfiguration

Verwenden Sie diese MCP-Server-Konfiguration:

{
  "mcpServers": {
    "trading212": {
      "command": "bun",
      "args": ["run", "src/server.ts"],
      "env": {
        "TRADING212_API_KEY": "your_api_key_here",
        "TRADING212_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

MCP-Tools

Konten

• fetch_account_cash

• fetch_account_metadata

Instrumente

• search_exchange

• search_instrument

Portfolio / Positionen

• fetch_open_positions

• search_specific_position_by_ticker

• fetch_open_position_by_ticker

Aufträge

• fetch_all_orders

• fetch_order

• place_limit_order

• place_market_order

• place_stop_order

• place_stop_limit_order

• cancel_order

Historie

• fetch_historical_order_data

• fetch_paid_out_dividends

• fetch_transaction_list

• fetch_exports_list

• request_export_csv

Pies

• fetch_pies

• fetch_pie

• create_pie

• update_pie

• duplicate_pie

• delete_pie

Server-Dienstprogramm

• get_server_health

Hinweise zur API-Nutzung

• Authentifizierung: Die Trading 212 Public API verwendet Basic Auth (API_KEY:API_SECRET), was vom BaseClient gehandhabt wird.

• Umgebungs-Routing: ENVIRONMENT=demo|live wird auf die Basis-URLs von Trading 212 (Demo/Live) gemappt.

• Paginierung: Historien-Endpunkte verwenden limit + cursor und geben nextPagePath zurück.

• Ratenbegrenzungen: Die API ist ratenbegrenzt; 429 wird als RATE_LIMIT_EXCEEDED ausgegeben.

Entwicklung

Skripte

• bun run build — TypeScript kompilieren

• bun run start — MCP-Server starten

• bun run dev — Watch-Modus

• bun test src — Tests in src ausführen

Fehlerbehebung

• Anmeldedaten fehlen: Setzen Sie TRADING212_API_KEY und TRADING212_API_SECRET.

• Authentifizierungsfehler: Generieren Sie die API-Anmeldedaten neu und starten Sie den Server neu.

• Claude kann keine Verbindung herstellen: Überprüfen Sie die Bun-Installation, den Befehlspfad und die Claude MCP-Konfiguration.