Trade Agent

Trade It MCP Server

👉 Vollständige Dokumentation hier 👈

Jetzt verfügbar über die Offizielle MCP-Registry

Inhaltsverzeichnis

• Übersicht
• Erste Schritte
• Verbinden
• Tools
  • Sicherheitsmodell (Entwurf-zuerst)
  • search_assets
  • get_accounts
  • create_trade
  • create_options_trade
    • OCC-Optionssymbol-Format
    • Options-JSON-Beispiele
  • execute_trade
• Trade-Status-Referenz
• Brokerage-IDs (API-Helfer)
• Haftungsausschlüsse

Übersicht

Der Trade It MCP Server bringt Aktien-, Krypto- und Optionshandel-Unterstützung für Agenten. Er ermöglicht die Interaktion in natürlicher Sprache mit Aktien- und Krypto-Brokern – führen Sie Trades aus, fragen Sie die Portfolio-Performance ab und erhalten Sie Markteinblicke, indem Sie Anfragen in einfachem Englisch über das MCP-Protokoll senden.

Endpunkte:

• Streamable HTTP: https://mcp.tradeit.app/mcp
• SSE: https://mcp.tradeit.app/sse

Broker-Unterstützung:

• Robinhood
• Charles Schwab
• E*Trade
• Webull
• Public
• Tastytrade

Krypto-Börsen-Unterstützung:

• Coinbase
• Kraken

Weitere folgen in Kürze!

Dieser Server ist remote, sodass Sie nichts lokal ausführen müssen, um eine Verbindung herzustellen. Verweisen Sie einfach Ihre MCP-kompatible Agentenplattform auf die obige URL.

---

Erste Schritte

1. Erstellen Sie zunächst ein Konto bei https://tradeit.app.
2. Melden Sie sich für die kostenlose Testversion des Pro-Tarifs an.
3. Verbinden Sie Ihren Broker Ihrer Wahl.

Verbinden

1. Verbinden Sie Ihren MCP-Client mit https://mcp.tradeit.app/mcp oder https://mcp.tradeit.app/sse.
2. Authentifizieren Sie sich über den browserbasierten OAuth-Flow.
3. Sie sind nun bereit für den Handel!

---

Tools

MCP-Tools verbinden Ihren Agenten mit verknüpften Brokern: Symbole suchen, Konten auflisten, Entwurfs-Aufträge erstellen und erst nach Bestätigung ausführen.

MCP-Tool	Funktion
search_assets	Eine Aktie oder Krypto anhand des Tickers oder Namens nachschlagen; gibt Preis und Metadaten zurück.
get_accounts	Verknüpfte Konten und Salden auflisten; wird auch beim Verknüpfen eines neuen Brokers verwendet.
create_trade	Einen Entwurf für einen Aktien-/Krypto-Kauf oder -Verkauf zur Überprüfung erstellen.
create_options_trade	Einen Entwurf für einen ein- oder mehrbeinigen Optionsauftrag zur Überprüfung erstellen.
execute_trade	Einen zuvor erstellten Entwurf nach ausdrücklicher Benutzerbestätigung an den Broker senden.

Sicherheitsmodell (Entwurf-zuerst)

Trades beginnen als draft-Aufträge und werden nicht an den Broker gesendet, bis der Benutzer eindeutig bestätigt.

Vorgesehener Ablauf:

1. Rufen Sie create_trade oder create_options_trade auf → Sie erhalten einen Entwurf mit einer trade_id.
2. Zeigen Sie dem Benutzer die vollständigen Auftragsdetails und wie er fortfahren kann.
3. Rufen Sie execute_trade nur auf, wenn der Benutzer ausdrücklich darum bittet, den Trade auszuführen, zu bestätigen oder zu platzieren.
4. Rufen Sie execute_trade nicht automatisch oder unmittelbar nach dem Erstellen eines Entwurfs auf.

Stellen Sie nach dem Erstellen eines Entwurfs sicher, dass der Benutzer weiß, dass er den Auftrag bei Bedarf platzieren kann (z. B. über die Ausführen-Steuerung Ihres Clients, falls verfügbar).

Optionale Schritte vor dem Erstellen eines Entwurfs:

• search_assets — Ticker und Kontext bestätigen.
• get_accounts — das richtige account_id auswählen, wenn dem Benutzer wichtig ist, welches Konto verwendet wird.

Ausführungsablauf:

User requests trade
       ↓
[Optional] search_assets — confirm ticker, get current price
       ↓
[Optional] get_accounts — identify correct account_id
       ↓
create_trade / create_options_trade → draft with trade_id, status: "draft"
       ↓
Show draft details; user confirms
       ↓
execute_trade(trade_id)
       ↓
Status: "placed" or "failed" (with details)

Konto- / Auftragsstandards: Wenn der Benutzer Betrag, Konto oder Auftragstyp auslässt, wendet Trade It seinen Standardbetrag, das Standardkonto und Market-Aufträge an, sofern zutreffend. Wenn Auto-Execute in den Trade It-Einstellungen aktiviert ist, kann das Verhalten in einigen Setups den manuellen Ausführungsschritt überspringen; im Zweifelsfall behandeln Sie die Ausführung dennoch als vom Benutzer bestätigt.

---

search_assets

Eine Aktie oder Krypto anhand des Tickers oder Namens nachschlagen.

• Parameter: query (String) – z. B. "TSLA", "Tesla", "bitcoin".
• Rückgabe: Preis, Ticker, Börse, Anlagetyp und zugehörige Metadaten.

Beispiel:

{ "query": "TSLA" }

Beispiele in natürlicher Sprache: "Wie steht es um Apple?" · "Wie ist der Preis von TSLA?"

---

get_accounts

Alle verknüpften Brokerage-Konten auflisten (und diesen Ablauf verwenden, wenn der Benutzer einen neuen Broker verbinden möchte).

• Parameter: keine.
• Rückgabe: Konten mit id, name, brokerage, balance, available_cash. Verwenden Sie account.id als account_id in Trade-Aufrufen, wenn ein bestimmtes Konto erforderlich ist.

Beispiel in natürlicher Sprache: "Zeige meine Konten."

---

create_trade

Einen Entwurf für einen Aktien- oder Krypto-Auftrag erstellen.

Parameter:

Feld	Typ	Erforderlich	Beschreibung
symbol	string	Ja	Ticker, z. B. "TSLA".
amount	number	Ja	Zu handelnde Größe.
unit	"dollars" oder "shares"	Ja	Einheit für amount.
buy_or_sell	"buy" oder "sell"	Ja	Richtung.
order_type	"market", "limit", "stop", "stop_limit"	Nein	Standardmäßig "market".
limit_price	number	Bei Limit / Stop_Limit	Maximaler oder minimaler Preis pro Anteil, je nach Fall.
stop_price	number	Bei Stop / Stop_Limit	Stop-Trigger-Preis.
time_in_force	"day", "gtc", "ioc", "fok"	Nein	Auslassen für Broker-Standard.
account_id	number	Nein	Auslassen für Standardkonto.

Auftragstypen:

Typ	Verwendung, wenn	Preisfelder
market	Ausführung zum aktuellen Marktpreis	Keine
limit	Nur zu limit_price oder besser	limit_price
stop	Market-Order wird bei stop_price ausgelöst	stop_price
stop_limit	Limit-Order wird bei stop_price ausgelöst	stop_price und limit_price

JSON-Beispiele:

Apple für 500 $ zum Marktpreis kaufen:

{ "symbol": "AAPL", "amount": 500, "unit": "dollars", "buy_or_sell": "buy" }

10 NVDA-Aktien nur kaufen, wenn der Preis auf 800 $ oder darunter fällt:

{ "symbol": "NVDA", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "limit", "limit_price": 800 }

5 Meta-Aktien verkaufen, wenn der Preis auf 450 $ fällt (Stop):

{ "symbol": "META", "amount": 5, "unit": "shares", "buy_or_sell": "sell", "order_type": "stop", "stop_price": 450 }

10 AAPL kaufen, wenn der Kurs über 200 $ steigt, maximal 202 $/Aktie zahlen:

{ "symbol": "AAPL", "amount": 10, "unit": "shares", "buy_or_sell": "buy", "order_type": "stop_limit", "stop_price": 200, "limit_price": 202 }

Bitcoin für 1.000 $ kaufen:

{ "symbol": "BTC", "amount": 1000, "unit": "dollars", "buy_or_sell": "buy" }

100 Tesla-Aktien verkaufen, gültig bis zur Streichung:

{ "symbol": "TSLA", "amount": 100, "unit": "shares", "buy_or_sell": "sell", "time_in_force": "gtc" }

Beispiele in natürlicher Sprache: "Kaufe 1000 $ Tesla" · "Kaufe 1000 $ Tesla nur, wenn der Preis auf 150 $ oder niedriger fällt" · "Verkaufe 10 Apple-Aktien, wenn der Preis auf 140 $ fällt" · "Kaufe eine Apple-Aktie, wenn sie 200 $ erreicht" · "Kaufe 10 Apple-Aktien, wenn sie auf 140 $ steigt, aber zahle nicht mehr als 142 $"

---

create_options_trade

Einen Entwurf für einen ein- oder mehrbeinigen Optionsauftrag erstellen (Spreads, Straddles usw.).

Parameter:

Feld	Typ	Erforderlich	Beschreibung
symbol	string	Ja	Basiswert-Ticker, z. B. "SPY".
legs	array	Ja	Ein oder mehrere Legs (siehe unten).
direction	"debit" oder "credit"	Mehrbeinig	"debit" = Sie zahlen; "credit" = Sie kassieren.
order_type	"market", "limit" usw.	Nein	Standardmäßig "market".
limit_price	number	Bei Limit	Netto-Debit-/Credit-Limit für das Paket.
time_in_force	"day" oder "gtc"	Nein	Auslassen für Standard.
account_id	number	Nein	Auslassen für Standardkonto.

Jeder Leg:

Feld	Typ	Erforderlich	Beschreibung
type	"option" oder "equity"	Ja	Leg-Typ.
action	"buy" oder "sell"	Ja	Seite des Legs.
position_effect	"open" oder "close"	Optionen	Eine neue Position eröffnen oder eine bestehende schließen.
occ	string oder null	Optionen	OCC-String (unten); null für Aktien-Legs.
quantity	number	Ja	Kontrakte (Optionen) oder Aktien (Equity).

OCC-Optionssymbol-Format

OCC-Strings folgen dem Schema: YYMMDD + C oder P + 8-stelliger Strike (Strike × 1000, mit Nullen aufgefüllt).

Beschreibung	OCC
20. Jun 2025 $250 Call	250620C00250000
20. Jun 2025 $260 Call	250620C00260000
21. Mär 2025 $500 Put	250321P00500000
19. Dez 2025 $1.500 Call	251219C01500000
16. Jan 2026 $50 Put	260116P00050000

Strike-Kodierung: Dollar mit 1.000 multiplizieren und auf 8 Stellen auffüllen (z. B. $250 → 00250000; $50,50 → 00050500).

Options-JSON-Beispiele

Einzelner Call — 1 SPY $520 Call, Verfall 20. Jun 2025, kaufen:

{
  "symbol": "SPY",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00520000", "quantity": 1 }
  ]
}

Bull Call Spread (Debit) — $250 Call kaufen, $260 Call verkaufen, gleiches Verfallsdatum:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

Bear Put Spread (Debit):

{
  "symbol": "SPY",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00520000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 }
  ]
}

Bull Put Spread (Credit):

{
  "symbol": "SPY",
  "direction": "credit",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620P00510000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00500000", "quantity": 1 }
  ]
}

Spread mit Limit — Netto-Debit $3,50 oder besser:

{
  "symbol": "TSLA",
  "direction": "debit",
  "order_type": "limit",
  "limit_price": 3.50,
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "sell", "position_effect": "open", "occ": "250620C00260000", "quantity": 1 }
  ]
}

Long Call schließen — 2 AAPL $200 Calls, Verfall 21. Mär 2025, verkaufen zum Schließen:

{
  "symbol": "AAPL",
  "legs": [
    { "type": "option", "action": "sell", "position_effect": "close", "occ": "250321C00200000", "quantity": 2 }
  ]
}

Straddle — $250 Call und $250 Put long, gleiches Verfallsdatum:

{
  "symbol": "TSLA",
  "direction": "debit",
  "legs": [
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620C00250000", "quantity": 1 },
    { "type": "option", "action": "buy", "position_effect": "open", "occ": "250620P00250000", "quantity": 1 }
  ]
}

Beispiele in natürlicher Sprache: "Kaufe 1 AAPL $300 Call mit Verfall nächsten Monat" · "Covered Call auf MSFT mit $500 Strike" · "TSLA Call Spread: kaufe $475 / verkaufe $485, nächste Woche" · "ATM Straddle auf SPY diesen Freitag" · "2 AMZN Puts, Limit $3,50" · "Verkaufe AMZN260130P00200000"

---

execute_trade

Einen Entwurf an den Broker senden, nachdem der Benutzer ihn überprüft hat.

• Parameter: trade_id (number) – die id des Entwurfs aus create_trade oder create_options_trade.
• Rückgabe: Aktualisierter Trade; Status "placed" oder "failed" (mit Fehlerdetails).

Nur aufrufen, wenn der Benutzer eindeutig bestätigt (z. B. ausführen, bestätigen, platzieren, los). Bestätigen Sie den Trade, der mit dem übereinstimmt, was er gerade überprüft hat.

Nicht automatisch direkt nach dem Erstellen eines Entwurfs aufrufen, ohne Auftragsdetails anzuzeigen, oder wenn der Status nicht "draft" ist.

---

Trade-Status-Referenz

Status	Bedeutung
draft	Erstellt; noch nicht an Broker gesendet
pending	Übermittelt; wartet auf Broker-Bestätigung
placed	Akzeptiert; wartet auf Ausführung
partially_filled	Teilweise ausgeführt
complete	Vollständig ausgeführt
canceled	Storniert
failed	Abgelehnt — Fehler prüfen
disconnected	Brokerage-Verbindungsproblem

Brokerage-IDs (API-Helfer)

Brokerage	ID	Optionen
Robinhood	1	Ja
E*TRADE	2	Ja
Coinbase	3	Nur Krypto
Kraken	5	Nur Krypto
Charles Schwab	7	Ja
Webull	8	Ja
Public	11	Ja
Tastytrade	12	Ja

Klarstellung: Fragen Sie einmal, mit allem, was Sie benötigen, wenn: der Auftragstyp mehrdeutig ist (z. B. „kaufe TSLA bei 200 $“ — Limit vs. Stop), bei Optionen Verfall/Strike fehlen, mehrere Konten infrage kommen und keines ausgewählt ist oder ein Symbol mehr als einen Vermögenswert bedeuten könnte. Überspringen Sie überflüssige Fragen, wenn die Standardwerte klar sind (Standardbetrag, Market-Order, Hauptkonto).

Haftungsausschlüsse

• Investieren birgt Risiken, einschließlich des möglichen Verlusts des eingesetzten Kapitals.
• Trade It ist kein Finanzberater und bietet keine Anlageberatung.
• Optionen sind mit erheblichen Risiken verbunden und nicht für alle Anleger geeignet.
• Trade It kann keine Gelder abheben, Vermögenswerte übertragen oder die Verwahrung übernehmen — es kann nur Trades über Ihre verknüpften Brokerage-Konten platzieren.

---