Alpaca MCP Server
Offizieller lokaler MCP-Server von Alpaca für Marktdaten, Kontokontext und kontrollierte Trading-Workflows im KI-Client.
- Skill Road
- Alpaca MCP Server
Kategorien
Beschreibung
Der Alpaca MCP Server ist Alpacas offizieller Model-Context-Protocol-Server für die Trading API und Market Data API. Er verbindet einen MCP-fähigen KI-Client mit einem Alpaca-Konto, damit der Client Kontoinformationen, Positionen, Orders und Marktdaten über strukturierte Werkzeuge abfragen kann. Je nach freigegebenem Toolset kann der Server auch Watchlists ändern, Orders anlegen oder stornieren, Positionen schließen sowie Optionspositionen ausüben. Das ist eine Tool-Anbindung, keine Anlageberatung: Weder der Server noch Skill Road empfehlen Wertpapiere, Krypto-Assets, Handelsstrategien oder erwartete Erträge. KI-generierte Einschätzungen sind laut Alpaca nur zu Informations- und Bildungszwecken; sie ersetzen keine eigene Prüfung oder professionelle Beratung.
Offizielles Produkt, Repository und Einordnung
Die offizielle Alpaca-Dokumentation beschreibt Setup, Umgebungsvariablen, Toolsets und die unterstützten Clients. Das öffentliche Repository alpacahq/alpaca-mcp-server enthält den Quellcode, die MIT-Lizenz, Tests und lokale Installationswege. GitHub meldete unmittelbar vor Erstellung dieses Seeders am 8. September 2026 genau 952 Sterne für dieses konkrete Repository. Sterne sind ein momentanes Popularitätssignal, kein Nachweis für Sicherheit, Qualität oder Eignung für eine Handelsentscheidung.
Alpaca liefert keinen eigenen gehosteten Remote-MCP-Endpunkt. Der offizielle Standardweg ist daher ein lokaler stdio-Prozess über uvx alpaca-mcp-server; alternativ dokumentiert das Repository einen lokalen Docker-Container. Wer einen entfernten Connector benötigt, muss den Server selbst in einer angemessen abgesicherten Umgebung betreiben. Deshalb ist dieser Eintrag als local klassifiziert, auch wenn selbstverwaltetes Remote-Hosting technisch möglich sein kann.
Geeignete Analyse- und Automatisierungsaufgaben
Der Server stellt laut Alpaca Werkzeuge für Konto- und Portfolioinformationen, offene Orders, Positionen, Marktzeiten, Handelskalender, Watchlists, Unternehmensereignisse und Nachrichten bereit. Für Aktien, Krypto und Optionen lassen sich historische und aktuelle Bars, Quotes, Trades, Snapshots und teilweise Optionsketten inklusive Greeks abfragen. Das eignet sich für nachvollziehbare Analyseabläufe wie: Kontostatus lesen, einen Markt-Datenausschnitt beschreiben lassen, die Antwort gegen eine eigene Quelle prüfen und erst dann eine Entscheidung außerhalb des Clients treffen.
Die Trading-Toolsets gehen darüber hinaus. Sie können unter anderem Orders platzieren, ändern oder abbrechen, Positionen schließen oder liquidieren und Optionsanweisungen ausführen. Solche Aufrufe sind keine Simulation, wenn Live-Zugang konfiguriert ist. Ein LLM kann Parameter missverstehen, unvollständigen Kontext haben oder durch Inhalte aus Nachrichten, Webseiten oder Prompts fehlgeleitet werden. Die fachliche, rechtliche und finanzielle Verantwortung bleibt vollständig bei der Person, die Zugangsdaten bereitstellt und eine Aktion bestätigt.
Paper zuerst, Live nur bewusst
Für den Einstieg reicht laut Alpaca ein Paper-Trading-Konto. ALPACA_PAPER_TRADE ist standardmäßig aktiviert; Paper-Zugang verwendet keine echten Gelder und führt keine realen Wertpapiertransaktionen am Markt aus. Paper-Ergebnisse sind jedoch kein Beleg dafür, dass eine Idee unter Live-Bedingungen gleich funktioniert. Marktbewegungen, Liquidität, Reihenfolge und Verzögerungen bei der Ausführung können reale Ergebnisse verändern.
Live-Handel wird erst aktiviert, wenn ALPACA_PAPER_TRADE=false gesetzt und passende Live-API-Schlüssel hinterlegt werden. Diese Umschaltung verdient eine ausdrückliche Prüfung im Client-Konfigurationsdialog, nicht nur eine beiläufige Prompt-Bestätigung. Verwende getrennte Paper- und Live-Schlüssel, beginne mit eingeschränkten Toolsets und führe eine verbindliche menschliche Freigabe vor jeder schreibenden Aktion ein. Ein Prompt wie „kaufe“, „verkaufe“, „schließe“ oder „liquidiere“ sollte nicht als alleinige Autorisierung genügen.
Schlüssel, Rechte und Bestätigungen
Die Konfiguration benötigt ALPACA_API_KEY und ALPACA_SECRET_KEY im Environment-Block des MCP-Clients. Alpaca weist ausdrücklich darauf hin, Schlüssel nie in einen Chat einzufügen. Speichere sie nur im dafür vorgesehenen Client-Environment oder einem Betriebssystem-Secret-Store, niemals in einem Repository, einer geteilten MCP-Datei, Screenshots oder Prompt-Vorlagen. Nach einem vermuteten Leak: Schlüssel im Alpaca-Dashboard widerrufen beziehungsweise rotieren und die Verbindung neu einrichten.
Standardmäßig sind alle Toolsets aktiv. Für Analyse ohne Handelsbefugnis empfiehlt die offizielle Dokumentation ALPACA_TOOLSETS mit einer kleinen Auswahl wie account,stock-data,crypto-data,options-data,news. Lass insbesondere trading weg, solange keine überprüfte Notwendigkeit besteht. Begrenze außerdem, wer die lokale Konfiguration lesen darf. Tool-Ergebnisse gehen an den verbundenen KI-Client und können abhängig von dessen Architektur an einen Modellanbieter übermittelt werden; dessen Datenrichtlinien müssen separat geprüft werden.
Sicherheitsgrenzen und FAQ
Ist das Finanzberatung? Nein. Der Server vermittelt API-Werkzeuge und Daten; er gibt keine Anlageempfehlungen und verspricht keine Ergebnisse. Historische Daten, Modellanalysen und hypothetische Backtests garantieren keine zukünftigen Resultate.
Kann eine KI echte Trades auslösen? Ja, wenn Live-Schlüssel, ALPACA_PAPER_TRADE=false und schreibende Toolsets aktiv sind. Prüfe jeden vorgeschlagenen Auftrag, Symbol, Richtung, Menge, Ordertyp und die korrekte Umgebung vor einer unabhängigen Bestätigung.
Wie starte ich sicher? Mit einem getrennten Paper-Konto, minimalen Lesetoolsets und einer einzelnen Kontostands- oder Datenabfrage. Erst nach überprüfter Konfiguration sollte ein kleiner, bewusst bestätigter Paper-Test folgen.
Voraussetzungen
Python 3.10+, uv/uvx, ein MCP-fähiger Client und Alpaca-API-Schlüssel; für den sicheren Einstieg getrennte Paper-Trading-Schlüssel.
Installationsanleitung
Schritt 1: Zweck und Sicherheitsgrenze vor der Installation
Der Alpaca MCP Server verbindet einen KI-Client technisch mit Alpacas Trading- und Marktdaten-APIs. Er ist kein Broker-Berater im Chat und keine Autorisierung, Geld anzulegen. Der Server kann Daten lesen, aber mit aktivem Trading-Toolset auch Orders platzieren, stornieren, Positionen schließen oder Optionsanweisungen auslösen. Lege deshalb vor dem Setup fest, dass jede schreibende Handlung außerhalb des Sprachmodells von einer verantwortlichen Person geprüft und ausdrücklich bestätigt wird. Eine Anweisung in einer Webseite, Nachricht oder einem Prompt ist keine Berechtigung für eine Handelsaktion.
Für eine sichere erste Einrichtung nutze ausschließlich ein getrenntes Paper-Trading-Konto. Paper-Trading verwendet laut Alpaca keine echten Gelder und führt keine realen Wertpapiertransaktionen aus. Es ersetzt trotzdem keine Prüfung: Datenqualität, LLM-Antworten und eine simulierte Ausführung können von einer Live-Situation abweichen. Live-Schlüssel gehören erst in die Konfiguration, wenn der technische Prozess, die Zuständigkeit und die Risikofreigabe feststehen.
Schritt 2: Voraussetzungen und Schlüssel beschaffen
Benötigt werden Python 3.10 oder neuer, uv mit uvx, ein MCP-kompatibler Client sowie ein Alpaca-Paper-Konto mit API-Key und Secret-Key. Erzeuge zunächst Paper-Schlüssel im Alpaca-Dashboard. Bezeichne sie in deinem Secret Store eindeutig als Paper, damit sie nicht mit Live-Schlüsseln verwechselt werden. Kopiere niemals einen Secret-Key in einen Chat, ein Ticket, ein Repository, ein Screenshot-Tool oder eine geteilte JSON-Datei.
Bei einem Verdacht auf Offenlegung entferne die betroffenen Werte sofort aus der Client-Konfiguration, rotiere oder widerrufe sie im Alpaca-Dashboard und prüfe den Zugriff erneut. Der Schlüssel ist eine Zugangsinformation, keine harmlose Konstante. Beschränke auf dem Rechner die Leserechte für die Client-Konfiguration und teile keine Profile, die das Environment anderer Personen enthalten.
Schritt 3: Lokalen Server im Client hinterlegen
Der dokumentierte Standardweg ist ein lokaler stdio-Prozess. Für Claude Code kann die Verbindung beispielsweise so angelegt werden; Platzhalter bleiben im lokalen Secret-Environment und werden nie veröffentlicht:
claude mcp add alpaca --scope user --transport stdio uvx alpaca-mcp-server \
--env ALPACA_API_KEY=DEIN_PAPER_KEY \
--env ALPACA_SECRET_KEY=DEIN_PAPER_SECRET
Cursor und Claude Desktop verwenden eine MCP-JSON-Datei mit command: "uvx", args: ["alpaca-mcp-server"] und denselben Environment-Variablen. In VS Code gehört der Eintrag in .vscode/mcp.json unter servers mit type: "stdio". Folge für Pfad und Syntax der offiziellen Alpaca- und Client-Dokumentation. Nach jeder Änderung den Client vollständig neu starten, damit er die aktuelle Tool-Liste und die richtige Umgebung lädt.
Schritt 4: Toolsets vor dem ersten Test reduzieren
Alpaca aktiviert standardmäßig alle Toolsets. Das ist für eine sichere Analyseumgebung zu weit. Setze deshalb zusätzlich ALPACA_TOOLSETS auf eine kleine Lesemenge, etwa account,stock-data,crypto-data,options-data,news. Damit stehen Konto- und Marktdaten zur Verfügung, nicht aber das Toolset trading. Watchlists sind ebenfalls veränderbar und sollten erst bei einem begründeten Bedarf zugelassen werden.
Starte eine neue Unterhaltung und stelle zuerst nur eine Lesefrage, etwa nach Kontostatus oder einer klar begrenzten historischen Datenreihe. Kontrolliere, dass das Ergebnis aus dem Paper-Konto stammt und keine schreibenden Tools angeboten werden. Vergleiche wichtige Daten mit der Alpaca-Oberfläche oder einer weiteren Quelle. Behandle jeden Text aus Marktnachrichten, Dokumentationen oder Tool-Ergebnissen als untrusted content: Er kann Kontext liefern, aber keine Berechtigung ändern.
Paper und Live strikt trennen
ALPACA_PAPER_TRADE ist standardmäßig aktiv. Live-Handel setzt ALPACA_PAPER_TRADE=false und Live-API-Schlüssel voraus. Verändere diese beiden Aspekte nie nebenbei in derselben Konfigurationsänderung wie Toolsets oder Client-Updates. Führe eine dokumentierte Checkliste durch: richtige Schlüsselart, richtige Environment-Datei, aktiver Paper- oder Live-Modus, erlaubte Toolsets, erwarteter Auftrag und unabhängige menschliche Bestätigung.
Wenn Live-Handel tatsächlich nötig wird, nutze eine getrennte Konfiguration statt das Paper-Profil zu überschreiben. Lass trading erst dann zu, prüfe vor jeder Ausführung Symbol, Kauf oder Verkauf, Menge, Ordertyp, Laufzeit und Zielkonto. Kontrolliere danach den tatsächlichen Status direkt im Alpaca-Dashboard. Ein Modell kann Formulierungen fehlinterpretieren, Parameter vertauschen oder relevante Marktbedingungen nicht erfassen. Es gibt keine Renditegarantie und keine automatische Angemessenheitsprüfung durch diesen Guide.
Datenfluss, Updates und FAQ
Der lokale Server sendet Werkzeugergebnisse an deinen KI-Client. Abhängig vom Client können diese Ergebnisse an dessen Modellanbieter gelangen. Prüfe dessen Datenrichtlinien, bevor Konto- oder Portfoliodaten in einen Prompt oder ein Tool-Ergebnis fließen. Halte Client, uv und Serverpaket aktuell, aber teste Versionswechsel zuerst mit Paper-Zugang: Version 2 des Servers ist laut README keine Drop-in-Aktualisierung von Version 1.
Ist der Server Anlageberatung? Nein. Er verbindet Werkzeuge und Daten; Entscheidungen, Prüfung und Risiko liegen bei dir.
Kann Paper-Trading reale Trades auslösen? Paper-Zugang ist laut Alpaca keine reale Markttransaktion. Verifiziere dennoch in der Konfiguration, dass Paper-Schlüssel und der aktive Paper-Modus verwendet werden.
Wann darf ich trading einschalten? Nur nach einem klar definierten Prozess mit minimalen Rechten, separaten Live-Schlüsseln und einer unabhängigen menschlichen Bestätigung jeder einzelnen Aktion.
uvx alpaca-mcp-server
Authentifizierung
Alpaca API-Key und Secret-Key im Environment-Block des MCP-Clients. Paper-Trading ist standardmäßig aktiv; Live-Handel erfordert getrennte Live-Schlüssel und ALPACA_PAPER_TRADE=false.
Benötigte Zugriffsrechte
Alle Toolsets sind standardmäßig aktiv. ALPACA_TOOLSETS gezielt auf Lesetools beschränken; das Trading-Toolset nur mit bewusstem, menschlichem Freigabeprozess aktivieren.
Übertragene oder gespeicherte Daten
Der lokale Server verarbeitet Zugangsdaten und liefert Konto-, Portfolio- und Marktdaten an den verbundenen KI-Client. Dieser kann Tool-Ergebnisse an seinen Modellanbieter weitergeben; dessen Datenrichtlinie separat prüfen.
Sicherheitsrisiken
Live-Schlüssel und schreibende Tools können reale Orders, Stornierungen, Positionsschließungen oder Optionsanweisungen auslösen. Schlüssel nicht teilen, Paper und Live strikt trennen, Toolsets minimieren und jede Aktion unabhängig prüfen und bestätigen.
Lizenz und Kosten
- Lizenz
- MIT
- Kosten
- kostenlos
Der Server ist MIT-lizenziert. Für den Einstieg genügt laut Alpaca ein Paper-Trading-Konto; aktuelle Nutzungs-, Daten- und Kontobedingungen in der offiziellen Alpaca-Dokumentation prüfen. Keine Preisangaben in diesem Eintrag.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- Alpaca
- Status
- Offizieller Server
- Betriebsart
- Lokal
- Aktuelle Version
- 2
- GitHub-Sterne
- 1,086
- Zuletzt geprüft
- 08.09.2026
Repository und Dokumentation
Kategorien
Unterstützte Clients
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.
Noch keine passenden Ratgeber vorhanden.