Alpaca MCP Server

Alpaca MCP Server v2 ist da. Diese Version ist eine vollständige Neuentwicklung mit FastMCP und OpenAPI. Wenn Sie von v1 aktualisieren, lesen Sie bitte den Upgrade-Leitfaden – Toolnamen, Parameter und Konfiguration haben sich geändert.

Inhaltsverzeichnis

• Upgrade von V1

• Voraussetzungen

• API-Schlüssel erhalten

• Einrichtung

• Konfiguration

• Funktionen

• Beispiel-Prompts

• Verfügbare Tools

• Tests

• Projektstruktur

• Fehlerbehebung

• Offenlegung

Related MCP server: Alpaca MCP Server

Upgrade von V1

V2 ist eine vollständige Neuentwicklung, die mit FastMCP und OpenAPI erstellt wurde. Keines der V1-Tools existiert in V2 – Toolnamen, Parameter und Schemas haben sich geändert. Sie können V2 nicht als Drop-in-Ersatz verwenden, wenn Ihre Einrichtung von bestimmten V1-Toolnamen oder -Parametern abhängt.

Was sich geändert hat

So vermeiden Sie V1-artige Nutzung in V2

MCP-Clients ermitteln Tools dynamisch vom Server. Es gibt keine Konfigurationsdatei, in der Sie Toolnamen auf eine Whitelist setzen – der Client erhält die Tools, die der Server bereitstellt. Damit Ihr Client oder KI-Assistent V2 nicht falsch verwendet:

1. Verwenden Sie die V1-Konfiguration nicht erneut – Behandeln Sie V2 als neuen Server. Aktualisieren Sie Ihre MCP-Client-Konfiguration mit den neuen Befehlen/Argumenten; entfernen Sie jegliche Einrichtung auf Basis von .env oder init.

2. Leeren Sie die Tool-Caches – Starten Sie Ihren MCP-Client (Claude Desktop, Cursor, VS Code usw.) nach dem Wechsel neu, damit er die neue Tool-Liste abruft, anstatt eine veraltete zu verwenden.

3. Starten Sie einen neuen Chat/eine neue Sitzung – Bestehende Konversationen können zwischengespeicherte Verweise auf alte Toolnamen enthalten. Starten Sie einen neuen Chat, damit das LLM die aktuellen V2-Tools und ihre Schemas sieht.

4. Aktualisieren Sie benutzerdefinierte Anweisungen und Regeln – Wenn Sie Cursor-Regeln, Claude-Anweisungen oder andere Prompts haben, die bestimmte V1-Toolnamen erwähnen (z. B. „verwenden Sie get_account_info“), passen Sie sie an die V2-Toolnamen an oder entfernen Sie diese Verweise und lassen Sie das LLM die Tools aus dem Kontext entdecken.

5. Schränken Sie Tools mit ALPACA_TOOLSETS ein – Wenn Sie zuvor festgelegt haben, welche Funktionen Ihr Assistent nutzen darf, unterstützt V2 serverseitige Filterung über die Umgebungsvariable ALPACA_TOOLSETS. Siehe Konfiguration > Toolset-Filterung für die Liste der Toolsets.

Zusammenfassung

Gehen Sie von keiner Abwärtskompatibilität mit V1 aus. Konfigurieren Sie Ihren MCP-Client für V2 neu, starten Sie ihn neu und verwenden Sie eine neue Sitzung. Lesen Sie im Abschnitt Verfügbare Tools die aktuelle Tool-Liste.

Falls Sie benutzerdefinierte V1-Workflows hatten

Wenn Sie erlaubte Tools dokumentiert, Skripte geschrieben haben, die Tools beim Namen aufrufen, oder Prompts um bestimmte V1-Tool-/Parameterformen herum aufgebaut haben – behandeln Sie sie als veraltet. Erstellen Sie sie neu mit den unten aufgeführten Verfügbaren Tools und den aktuellen Parameterschemata, die der Server bereitstellt.

Auf V1 bleiben

Wenn Sie auf V1 bleiben müssen, fixieren Sie in Ihrer MCP-Client-Konfiguration die letzte V1-Version (z. B. uvx alpaca-mcp-server==1.x.x serve). V1 bleibt für bestehende Einrichtungen auf PyPI verfügbar.

Voraussetzungen

• Python 3.10+ (Installationsanleitung)

• uv (Installationsanleitung)

• Alpaca-Trading-API-Schlüssel (kostenloses Paper-Trading-Konto)

• MCP-Client (Claude Desktop, Cursor, VS Code usw.)

API-Schlüssel erhalten

1. Besuchen Sie das Alpaca Dashboard

2. Erstellen Sie ein kostenloses Paper-Trading-Konto

3. Generieren Sie die API-Schlüssel über das Dashboard

Einrichtung

Fügen Sie den Server zu Ihrer MCP-Client-Konfiguration hinzu und starten Sie dann den Client neu. Kein init-Befehl, keine .env-Dateien – die Anmeldedaten werden an nur einer Stelle festgelegt.

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

Claude Mobile

Alpaca stellt keinen gehosteten Remote-MCP-Server bereit. Um den MCP-Server in der Claude-Mobile-App zu verwenden, hosten Sie ihn remote bei einem Cloud-Anbieter und fügen Sie ihn dann in Claude als benutzerdefinierten Connector hinzu. Der Connector wird mit der Mobile-App synchronisiert, sobald er im Web verbunden ist.

Informationen zu Hosting, Bereitstellung und Connector-Einrichtung finden Sie unter So stellen Sie Alpacas MCP-Server remote in der Claude Mobile App bereit.

ChatGPT

Alpaca stellt keinen gehosteten Remote-MCP-Server bereit. Um den MCP-Server in ChatGPT zu verwenden, hosten Sie ihn remote bei einem Cloud-Anbieter und fügen Sie ihn dann als Connector hinzu.

Weitere Informationen zu Hosting und Einrichtung finden Sie unter Connectors in ChatGPT und im Bereitstellungsleitfaden für Claude Mobile.

Cursor

Installieren Sie in wenigen Klicks aus dem Cursor Directory oder fügen Sie es zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

VS Code

Erstellen Sie .vscode/mcp.json im Stammverzeichnis Ihres Projekts. Siehe die offizielle Dokumentation.

{
  "mcp": {
    "servers": {
      "alpaca": {
        "type": "stdio",
        "command": "uvx",
        "args": ["alpaca-mcp-server"],
        "env": {
          "ALPACA_API_KEY": "your_alpaca_api_key",
          "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
        }
      }
    }
  }
}

PyCharm

Siehe die offizielle Anleitung.

1. Gehen Sie zu File → Settings → Tools → Model Context Protocol (MCP)

2. Fügen Sie einen neuen Server hinzu:

• Typ: stdio

• Befehl: uvx

• Argumente: alpaca-mcp-server

3. Legen Sie die Umgebungsvariablen fest:

 ALPACA_API_KEY=your_alpaca_api_key
 ALPACA_SECRET_KEY=your_alpaca_secret_key

Claude Code

claude mcp add alpaca --scope user --transport stdio uvx alpaca-mcp-server \
  --env ALPACA_API_KEY=your_alpaca_api_key \
  --env ALPACA_SECRET_KEY=your_alpaca_secret_key

Überprüfen Sie mit /mcp in der Claude Code CLI.

Antigravity CLI

Siehe die Antigravity-MCP-Dokumentation.

Fügen Sie die Konfiguration zu ~/.gemini/antigravity-cli/mcp_config.json (global) oder .agents/mcp_config.json (Arbeitsbereich) hinzu:

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

Docker

git clone https://github.com/alpacahq/alpaca-mcp-server.git
cd alpaca-mcp-server
docker build -t mcp/alpaca:latest .

Fügen Sie die Konfiguration zu Ihrer MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "alpaca": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ALPACA_API_KEY=your_key",
        "-e", "ALPACA_SECRET_KEY=your_secret",
        "-e", "ALPACA_PAPER_TRADE=true",
        "mcp/alpaca:latest"
      ]
    }
  }
}

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen, die in Ihrer MCP-Client-Konfiguration festgelegt werden. Es werden keine Dateien auf die Festplatte geschrieben.

Wechsel zum Live-Handel

Aktualisieren Sie den env-Block in Ihrer MCP-Client-Konfiguration und starten Sie neu:

{
  "env": {
    "ALPACA_API_KEY": "your_live_api_key",
    "ALPACA_SECRET_KEY": "your_live_secret_key",
    "ALPACA_PAPER_TRADE": "false"
  }
}

Toolset-Filterung

Standardmäßig sind alle Tools aktiviert. Um den Server auf bestimmte Toolsets zu beschränken, setzen Sie ALPACA_TOOLSETS:

{
  "env": {
    "ALPACA_API_KEY": "...",
    "ALPACA_SECRET_KEY": "...",
    "ALPACA_TOOLSETS": "stock-data,crypto-data"
  }
}

Verfügbare Toolsets:

ReadMe Docs MCP

Die Dokumentation ist auf die Spezifikationen der Trading API, Market Data API und Authentication API beschränkt; die Dokumentation der Broker-API-Endpunkte ist bewusst von diesem Server ausgeschlossen.

Wenn der ReadMe-MCP-Abruf fehlschlägt, enthalten die Tool-Antworten Fallback-Links zu Alpacas öffentlicher Dokumentation sowie zu llms.txt und llms-full.txt.

Funktionen

• Marktdaten – Echtzeit-Quotes, Trades und Kurs-Bars für Aktien, Krypto und Optionen. Historische Daten mit flexiblen Zeiträumen. Options-Greeks und implizite Volatilität.

• Kontoverwaltung – Salden, Kaufkraft, Kontostatus und Portfolioverlauf anzeigen.

• Orderverwaltung – Market-, Limit-, Stop-, Stop-Limit- und Trailing-Stop-Orders für Aktien, Krypto und Optionen aufgeben. Orders einzeln oder gesammelt stornieren.

• Optionshandel – Kontrakte nach Ablaufdatum/Strike/Typ suchen. Ein- oder mehrbeinige Strategien aufgeben. Aktuelle Quotes, Greeks und IV abrufen.

• Krypto-Handel – Market-, Limit- und Stop-Limit-Orders mit GTC/IOC. Mengen- oder Nominalwert-basiert.

• Positionsverwaltung – Positionen anzeigen, schließen oder liquidieren. Optionskontrakte ausüben.

• Nachrichten – Nachrichtenartikel, filterbar nach Ticker und Datumsbereich.

• Marktstatus – Marktöffnungs- und -schließungszeiten, Kalender, Corporate Actions.

• Watchlists – Watchlists erstellen, aktualisieren und verwalten.

• Asset-Suche – Details zu Aktien, ETFs, Krypto und Optionen mit Filterung abfragen.

Beispiel-Prompts

Grundlegender Handel

1. Wie hoch sind mein aktueller Kontostand und meine Kaufkraft bei Alpaca?

2. Zeigen Sie mir meine aktuellen Positionen in meinem Alpaca-Konto.

3. Kaufen Sie 5 Aktien von AAPL zum Marktpreis.

4. Verkaufen Sie 5 Aktien von TSLA mit einem Limitpreis von 300 $.

5. Stornieren Sie alle offenen Aktienaufträge.

6. Stornieren Sie den Auftrag mit der ID abc123.

7. Liquidieren Sie meine gesamte Position in GOOGL.

8. Schließen Sie 10 % meiner Position in NVDA.

9. Platzieren Sie einen Limitauftrag zum Kauf von 100 Aktien von MSFT zu 450 $.

10. Platzieren Sie einen Marktauftrag zum Verkauf von 25 Aktien von META.

Krypto-Handel

1. Platzieren Sie einen Marktauftrag zum Kauf von 0.01 ETH/USD.

2. Platzieren Sie einen Limitauftrag zum Verkauf von 0.01 BTC/USD zu $110,000.

Optionshandel

1. Zeigen Sie mir verfügbare Optionskontrakte für AAPL, die nächsten Monat auslaufen.

2. Holen Sie das neueste Angebot für die Option AAPL250613C00200000.

3. Rufen Sie den Options-Snapshot für die Option SPY250627P00400000 ab.

4. Liquidieren Sie meine Position in 2 Kontrakten von QQQ-Calls, die nächste Woche auslaufen.

5. Platzieren Sie einen Marktauftrag zum Kauf von 1 Call-Option auf AAPL, die nächsten Freitag ausläuft.

6. Wie sind die Options-Griechen für die Option TSLA250620P00500000?

7. Finden Sie TSLA-Optionskontrakte mit Ausübungspreisen innerhalb von 5 % des aktuellen Marktpreises.

8. Holen Sie SPY-Call-Optionen, die in der Woche vom 16. Juni 2025 auslaufen, innerhalb von 10 % des Marktpreises.

9. Platzieren Sie einen Bull-Call-Spread mit AAPL-Optionen vom 6. Juni: eine mit einem Strike von 190.00 und die andere mit einem Strike von 200.00.

10. Üben Sie meinen NVDA-Call-Optionskontrakt NVDA250919C001680 aus.

Marktinformationen

Um auf die neuesten 15-Minuten-Daten zuzugreifen, müssen Sie den Algo Trader Plus Plan abonnieren.

1. Was sind die heutigen Marktöffnungs- und -schließungszeiten?

2. Zeigen Sie mir den Marktkalender für nächste Woche.

3. Zeigen Sie mir die letzten Bardividenden und Aktiensplits für AAPL, MSFT und GOOGL in den letzten 3 Monaten.

4. Holen Sie alle Unternehmensmaßnahmen für SPY, einschließlich Dividenden, Splits und Fusionen im letzten Jahr.

5. Welche bevorstehenden Unternehmensmaßnahmen sind für SPY in den nächsten 6 Monaten geplant?

Historische & Echtzeitdaten

1. Zeigen Sie mir die tägliche Kurshistorie von AAPL für die letzten 5 Handelstage.

2. Wie war der Schlusskurs von TSLA gestern?

3. Holen Sie den neuesten Balken für GOOGL.

4. Was war der letzte Handelspreis für NVDA?

5. Zeigen Sie mir das aktuellste Angebot für MSFT.

6. Rufen Sie die letzten 100 Trades für AMD ab.

7. Zeigen Sie mir 1-Minuten-Balken für AMZN aus den letzten 2 Stunden.

8. Holen Sie 5-Minuten-Intraday-Balken für TSLA von letztem Dienstag bis letztem Freitag.

9. Holen Sie einen umfassenden Aktien-Snapshot für AAPL, der das neueste Angebot, den Trade, den Minutenbalken, den Tagesbalken und den vorherigen Tagesbalken in einer Ansicht zeigt.

10. Vergleichen Sie Markt-Snapshots für TSLA, NVDA und MSFT, um deren aktuelle Geld-/Brief-Spannen, letzte Handelspreise und Tagesperformance zu analysieren.

Aufträge

1. Zeigen Sie mir alle meine offenen und ausgeführten Aufträge von dieser Woche.

2. Welche Aufträge habe ich für AAPL?

3. Listen Sie alle Limitaufträge auf, die ich in den letzten 3 Tagen platziert habe.

4. Filtern Sie alle Aufträge nach Status: ausgeführt.

5. Holen Sie mir die Auftragshistorie für gestern.

Beobachtungslisten

Derzeit können Sie nur Handels-Beobachtungslisten, die über die Alpaca Trading API erstellt wurden, über die API selbst anzeigen und aktualisieren.

1. Erstellen Sie eine neue Beobachtungsliste namens „Tech Stocks“ mit AAPL, MSFT und NVDA.

2. Aktualisieren Sie meine Beobachtungsliste „Tech Stocks“ um TSLA und AMZN.

3. Welche Aktien sind in meiner Beobachtungsliste „Dividend Picks“?

4. Entfernen Sie META aus meiner Beobachtungsliste „Growth Portfolio“.

5. Listen Sie alle meine vorhandenen Beobachtungslisten auf.

Asset-Informationen

1. Suchen Sie nach Details zum Asset „AAPL“.

2. Zeigen Sie mir die Top-5-handelbaren Krypto-Assets nach Handelsvolumen.

3. Holen Sie alle aktiven US-Aktien-Assets von NASDAQ und filtern Sie die Ergebnisse, um nur handelbare Wertpapiere anzuzeigen.

Kombinierte Szenarien

1. Holen Sie die heutige Marktuhr und zeigen Sie mir meine Kaufkraft, bevor Sie einen Limit-Kaufauftrag für TSLA zu 340 $ platzieren.

2. Platzieren Sie einen Bull-Call-Spread mit SPY-Optionen vom 3. Juli: Verkaufen Sie eine 5 % über und kaufen Sie eine 3 % unter dem aktuellen SPY-Preis.

Verfügbare Tools

Konto & Portfolio

• get_account_info — Kontostand, Marge und Kontostatus

• get_account_config — Handelsbeschränkungen, Margin-Einstellungen, PDT-Prüfungen

• update_account_config — Kontokonfigurationseinstellungen aktualisieren

• get_portfolio_history — Eigenkapital und Gewinn/Verlust im Zeitverlauf

• get_account_activities — Ausführungen, Dividenden, Überweisungen

• get_account_activities_by_type — Aktivitäten nach Typ gefiltert

Handel (Aufträge)

• get_orders — Aufträge mit Filtern abrufen

• get_order_by_id — Einzelnen Auftrag nach ID abrufen

• get_order_by_client_id — Einzelnen Auftrag nach Client-Auftrags-ID abrufen

• replace_order_by_id — Einen bestehenden offenen Auftrag ersetzen

• cancel_order_by_id — Einen bestimmten Auftrag stornieren

• cancel_all_orders — Alle offenen Aufträge stornieren

• place_stock_order — Aktien/ETFs (Markt, Limit, Stop, Stop-Limit, Trailing-Stop, Brackets)

• place_crypto_order — Krypto (Markt, Limit, Stop-Limit)

• place_option_order — Optionen (einbeinig oder mehrbeinig)

Positionen

• get_all_positions — Alle aktuellen Positionen

• get_open_position — Details für eine bestimmte Position

• close_position — Eine bestimmte Position schließen

• close_all_positions — Gesamtes Portfolio liquidieren

• exercise_options_position — Einen gehaltenen Optionskontrakt ausüben

• do_not_exercise_options_position — Anweisung zur Nichtausübung

Beobachtungslisten

• create_watchlist — Eine neue Beobachtungsliste erstellen

• get_watchlists — Alle Beobachtungslisten auflisten

• get_watchlist_by_id — Eine bestimmte Beobachtungsliste abrufen

• update_watchlist_by_id — Eine Beobachtungsliste aktualisieren

• delete_watchlist_by_id — Eine Beobachtungsliste löschen

• add_asset_to_watchlist_by_id — Ein Asset zu einer Beobachtungsliste hinzufügen

• remove_asset_from_watchlist_by_id — Ein Asset aus einer Beobachtungsliste entfernen

Assets & Marktinformationen

• get_all_assets — Assets mit optionaler Filterung auflisten

• get_asset — Detaillierte Informationen zu einem bestimmten Asset

• get_option_contracts — Optionskontrakte für zugrunde liegende Symbole

• get_option_contract — Einzelnen Optionskontrakt nach Symbol oder ID

• get_calendar — Marktkalender für einen Datumsbereich

• get_clock — Aktueller Marktstatus und nächste Öffnung/Schließung

• get_corporate_action_announcements — Ankündigungen zu Unternehmensmaßnahmen

• get_corporate_action_announcement — Einzelne Ankündigung nach ID

Aktiendaten

• get_stock_bars — Historische OHLCV-Balken

• get_stock_quotes — Historische Geld-/Brief-Kurse

• get_stock_trades — Historische Trades

• get_stock_latest_bar — Neuester Minutenbalken

• get_stock_latest_quote — Neuestes Angebot

• get_stock_latest_trade — Neuester Trade

• get_stock_snapshot — Umfassender Snapshot

• get_most_active_stocks — Am aktivsten nach Volumen/Handelsanzahl

• get_market_movers — Top-Gewinner und -Verlierer

Krypto-Daten

• get_crypto_bars — Historische OHLCV-Balken

• get_crypto_quotes — Historische Kurse

• get_crypto_trades — Historische Trades

• get_crypto_latest_bar — Neuester Minutenbalken

• get_crypto_latest_quote — Neuestes Angebot

• get_crypto_latest_trade — Neuester Trade

• get_crypto_snapshot — Umfassender Snapshot

• get_crypto_latest_orderbook — Neuestes Orderbuch

Optionsdaten

• get_option_bars — Historische OHLCV-Balken

• get_option_trades — Historische Trades

• get_option_latest_trade — Neuester Trade

• get_option_latest_quote — Neuestes Angebot mit Geld-/Brief- und Börseninformationen

• get_option_snapshot — Snapshot mit Griechen und IV

• get_option_chain — Vollständige Optionskette für einen Basiswert

• get_option_exchange_codes — Zuordnung von Börsencodes zu Namen

Unternehmensmaßnahmen

• get_corporate_actions — Ankündigungen zu Unternehmensmaßnahmen aus Marktdaten

Nachrichten

• get_news — Nachrichtenartikel für Aktien und Krypto

Festzinsdaten

• get_fixed_income_latest_quotes — Neueste Kurse für festverzinsliche Wertpapiere nach ISIN

Locates (Leerverkauf)

• get_locates — Locate-Anfragen nach Status, Symbol oder Datumsbereich gefiltert auflisten

• create_locate — Eine Locate-Anfrage für einen Leerverkauf erstellen

• get_locate — Eine einzelne Locate-Anfrage nach ID abrufen

• get_locate_quotes — Locate-Verfügbarkeit und Preise für Symbole abrufen

Dokumentation

• search_alpaca_docs — Alpaca-Dokumentationsseiten und -Anleitungen durchsuchen

• fetch_alpaca_doc — Eine Alpaca-ReadMe-Dokumentationsseite nach Seiten-ID abrufen

• search_alpaca_api_specs — Alpaca-API-Referenzendpunkte nach Thema, Pfad, Parameter oder Schema-Begriff durchsuchen

• list_alpaca_api_endpoints — Endpunkte für eine zulässige Alpaca-OpenAPI-Spezifikation auflisten

• get_alpaca_endpoint_docs — Referenzdokumentation für einen genauen Alpaca-API-Endpunkt nach Methode und Pfad abrufen

Testen

Das Projekt umfasst eine mehrschichtige Testsuite, die bei jedem Pull-Request in CI ausgeführt wird:

• Integritätstests — Validieren die Konsistenz zwischen OpenAPI-Spezifikationen, Toolset-Definitionen und Tool-Namen-/Beschreibungs-Overrides. Kein Netzwerk oder Anmeldeinformationen erforderlich.

• Serverkonstruktionstests — Erstellen den Server mit simulierten Anmeldeinformationen und überprüfen, ob die richtige Anzahl von Tools verfügbar ist. Kein Netzwerk erforderlich.

• Paper-API-Integrationstests — Führen echte Aufrufe gegen die Alpaca-Paper-Trading-API aus, die Kontoinformationen, Marktdaten, Auftragslebenszyklus, Beobachtungslisten, Positionen und mehr abdecken. Erfordert ALPACA_API_KEY und ALPACA_SECRET_KEY.

• ReadMe-Integrationstests — Führen Live-Dokumentationsabrufe gegen Alpacas ReadMe MCP aus. Erfordert ALPACA_RUN_README_INTEGRATION=true, wenn lokal ausgeführt.

Führen Sie die vollständige Suite lokal aus:

# Core tests (no credentials needed)
pytest tests/test_integrity.py tests/test_server_construction.py -v

# Integration tests (requires paper API keys)
ALPACA_API_KEY=... ALPACA_SECRET_KEY=... pytest tests/ -m integration -v

# ReadMe docs integration tests (requires network, no Alpaca credentials)
ALPACA_RUN_README_INTEGRATION=true pytest tests/test_readme_integration.py -v

Projektstruktur

alpaca-mcp-server/
├── src/
│   └── alpaca_mcp_server/
│       ├── __init__.py
│       ├── cli.py            ← CLI entry point
│       ├── server.py         ← FastMCP server built from OpenAPI specs
│       ├── tool_registry.py  ← Tool names, descriptions, and output risk classifications
│       ├── toolsets.py       ← Toolset → operationId allowlists
│       ├── overrides.py      ← Hand-crafted tools for complex trading endpoints
│       ├── market_data_overrides.py ← Hand-crafted tools for historical data
│       ├── readme_docs.py    ← Read-only proxy tools for Alpaca ReadMe docs
│       └── specs/
│           ├── trading-api.json
│           └── market-data-api.json
├── tests/
│   ├── conftest.py           ← Shared fixtures and paper-account cleanup
│   ├── test_integrity.py     ← Spec ↔ toolset ↔ names consistency checks
│   ├── test_server_construction.py ← Server build verification
│   ├── test_readme_integration.py ← Live ReadMe docs MCP integration tests
│   └── test_paper_integration.py   ← Paper API integration tests
├── scripts/
│   └── sync-specs.sh        ← Download latest OpenAPI specs
├── .github/
│   └── workflows/
│       └── ci.yml            ← CI pipeline (core + integration)
├── AGENTS.md                 ← Instructions for coding agents
├── pyproject.toml
└── README.md

Fehlerbehebung

• uv/uvx nicht gefunden: Installieren Sie uv gemäß der offiziellen Anleitung (https://docs.astral.sh/uv/getting-started/installation/) und starten Sie dann Ihr Terminal neu, damit uv/uvx im PATH sind.

• Anmeldeinformationen fehlen: Setzen Sie ALPACA_API_KEY und ALPACA_SECRET_KEY im env-Block des Clients. Der Standardmodus für Paper Trading ist ALPACA_PAPER_TRADE = True.

• Client hat neue Konfiguration nicht übernommen: Starten Sie den Client (Cursor, Claude Desktop, VS Code) nach Änderungen neu.

• HTTP-Portkonflikte: Wenn Sie --transport streamable-http verwenden, ändern Sie --port auf einen freien Port.

Offenlegung

Die von unserem MCP-Server und den verbundenen KI-Agenten generierten Erkenntnisse dienen nur zu Bildungs- und Informationszwecken und sollten nicht als Anlageberatung verstanden werden. Alpaca empfiehlt keine bestimmten Wertpapiere oder Anlagestrategien. Bitte führen Sie vor Entscheidungen Ihre eigene Sorgfaltspflicht durch. Alle genannten Firmen arbeiten unabhängig und haften nicht füreinander.

Der Optionshandel ist aufgrund seines inhärent hohen Risikos, das möglicherweise zu erheblichen Verlusten führen kann, nicht für alle Anleger geeignet. Bitte lesen Sie die Merkmale und Risiken standardisierter Optionen (Options-Disclosure-Dokument), bevor Sie in Optionen investieren.

Alpaca erstellt, bearbeitet, unterstützt oder genehmigt keine Inhalte Dritter. Alpaca übernimmt keine Garantie für die Richtigkeit, Aktualität, Vollständigkeit oder Nützlichkeit von Inhalten Dritter und ist nicht verantwortlich oder haftbar für Inhalte, Werbung, Produkte oder andere Materialien auf oder von Websites Dritter.

Alle Investitionen sind mit Risiken verbunden, und die frühere Wertentwicklung eines Wertpapiers oder Finanzprodukts garantiert keine zukünftigen Ergebnisse oder Renditen. Es gibt keine Garantie, dass eine Anlagestrategie ihre Ziele erreicht. Bitte beachten Sie, dass Diversifikation keinen Gewinn sichert oder vor Verlusten schützt. Es besteht immer die Möglichkeit, Geld zu verlieren, wenn Sie in Wertpapiere oder andere Finanzprodukte investieren. Anleger sollten ihre Anlageziele und Risiken vor einer Investition sorgfältig abwägen.

Die Berechnungen des Algorithmus basieren auf historischen und Echtzeit-Marktdaten, berücksichtigen jedoch möglicherweise nicht alle Marktfaktoren, einschließlich plötzlicher Kursbewegungen, Liquiditätsbeschränkungen oder Ausführungsverzögerungen. Modellannahmen wie Volatilitätsschätzungen und Dividendenbehandlungen können die Leistung und Genauigkeit beeinflussen. Vom Algorithmus generierte Trades unterliegen Broker-Ausführungsprozessen, Marktliquidität, Auftragspriorität und Zeitverzögerungen. Diese Faktoren können zu Abweichungen von den erwarteten Ausführungspreisen oder -zeiten führen. Benutzer sind dafür verantwortlich, algorithmische Aktivitäten zu überwachen und die damit verbundenen Risiken zu verstehen. Alpaca haftet nicht für Verluste, die durch die Nutzung dieses Systems entstehen.

Hypothetische Backtest-Ergebnisse aus der Vergangenheit garantieren keine zukünftigen Renditen, und die tatsächlichen Ergebnisse können von der Analyse abweichen.

Die Paper Trading API wird von AlpacaDB, Inc. angeboten und erfordert weder echtes Geld noch gestattet sie einem Benutzer, mit echten Wertpapieren am Markt zu handeln. Die Bereitstellung der Paper Trading API ist kein Angebot und keine Aufforderung zum Kauf oder Verkauf von Wertpapieren, Wertpapierderivaten oder Futures-Produkten jeglicher Art und auch keine wie auch immer geartete Handels- oder Anlageberatung, Empfehlung oder Strategie, die von AlpacaDB, Inc. oder einem mit AlpacaDB, Inc. verbundenen Unternehmen erteilt oder in irgendeiner Weise gebilligt wird. Die über die Paper Trading API bereitgestellten Informationen stellen in keiner Rechtsordnung, in der AlpacaDB, Inc. oder ein mit AlpacaDB, Inc. verbundenes Unternehmen (gemeinsam „Alpaca“) nicht geschäftstätig werden darf, ein Angebot oder eine Aufforderung jeglicher Art dar.

Wertpapier-Brokerage-Dienstleistungen werden von der Alpaca Securities LLC („Alpaca Securities“), Mitglied von FINRA/SIPC, einer hundertprozentigen Tochtergesellschaft von AlpacaDB, Inc., erbracht. Technologie und Dienstleistungen werden von AlpacaDB, Inc. angeboten.

Kryptowährungsdienstleistungen werden von der Alpaca Crypto LLC („Alpaca Crypto“), einem bei FinCEN registrierten Gelddienstleistungsunternehmen (NMLS # 2160858) und einer hundertprozentigen Tochtergesellschaft von AlpacaDB, Inc., erbracht. Alpaca Crypto ist kein Mitglied von SIPC oder FINRA. Kryptowährungen sind keine Aktien, und Ihre Kryptowährungsinvestitionen sind weder durch die FDIC noch durch SIPC geschützt. Kryptowerte sind äußerst volatil und spekulativ, bergen ein erhebliches Verlustrisiko und sind nicht durch die FDIC oder eine staatliche Behörde versichert. Kunden sollten sich der verschiedenen Risiken bewusst sein, bevor sie diese Dienste in Anspruch nehmen, einschließlich des möglichen Kapitalverlusts, Cybersicherheitserwägungen, regulatorischer Entwicklungen und der sich weiterentwickelnden Natur der Technologie digitaler Vermögenswerte. Weitere Informationen zu den Risiken von Kryptowährungen finden Sie hier.

Dies ist kein Angebot, keine Aufforderung zur Abgabe eines Angebots und keine Beratung zum Kauf oder Verkauf von Wertpapieren oder Kryptowährungen oder zur Eröffnung eines Brokerage-Kontos oder Kryptowährungskontos in Rechtsordnungen, in denen Alpaca Securities bzw. Alpaca Crypto nicht registriert oder lizenziert sind, sofern dies jeweils zutrifft.

Datenschutzerklärung

Informationen darüber, wie Alpaca mit Ihren Daten umgeht, finden Sie hier:

• Datenschutzerklärung

• Offenlegungsbibliothek

Datenerhebung

• Was wird erhoben: User-Agent-Zeichenfolge (APCA-MCP-TRADING/<version>) für API-Aufrufe

• Verwendungszweck: Zur Identifizierung der MCP-Server-Nutzung und Verbesserung der Benutzererfahrung

• Weitergabe an Dritte: Nicht an Dritte weitergegeben

• Aufbewahrung: Gemäß der standardmäßigen Datenaufbewahrungsrichtlinie von Alpaca

• Opt-out: Setzen Sie die Umgebungsvariable ALPACA_MCP_USER_AGENT auf eine leere Zeichenfolge; es wird kein User-Agent-Header gesendet

Sicherheitshinweis

Dieser Server kann echte Trades platzieren und auf Ihr Portfolio zugreifen. Behandeln Sie Ihre API-Schlüssel als vertrauliche Anmeldeinformationen. Überprüfen Sie alle vom LLM vorgeschlagenen Aktionen sorgfältig, insbesondere bei komplexen Optionsstrategien oder Trades mit mehreren Beinen.

HTTP-Transportsicherheit: Bei Verwendung des HTTP-Transports verwendet der Server aus Sicherheitsgründen standardmäßig localhost (127.0.0.1:8000). Für den Fernzugriff können Sie den Server mit --host 0.0.0.0 an alle Schnittstellen binden, SSH-Tunneling verwenden (ssh -L 8000:localhost:8000 user@server) oder einen Reverse-Proxy mit Authentifizierung für einen sicheren Zugriff einrichten.

Support

Bei Problemen oder Fragen kontaktieren Sie uns bitte unter support@alpaca.markets.

GitHub Issues: https://github.com/alpacahq/alpaca-mcp-server/issues GitHub Pull requests: https://github.com/alpacahq/alpaca-mcp-server/pulls

Metadaten der MCP-Registry

mcp-name: io.github.alpacahq/alpaca-mcp-server