Octagon

Octagon: MCP für Public- & Prediction-Market-Intelligence

Der Octagon MCP-Server bietet spezialisierte KI-gestützte Finanzrecherche und -analyse durch Integration mit der Octagon Market Intelligence API. Er ermöglicht Nutzern die Analyse und Gewinnung von Erkenntnissen aus öffentlichen Einreichungen, Earnings Calls, Finanzkennzahlen, Aktien- & Kryptodaten, Aktiennachrichten sowie Nachrichten und Research zu Prognosemärkten – direkt in Claude Desktop und anderen gängigen MCP-Clients.

Tools

✅ octagon-agent orchestriert umfassende Marktintelligence-Analysen

• Public-Market-Einblicke: SEC-Einreichungen (10-K, 10-Q, 20-F, 8-K, S-1, 13-F, DEF 14A), Transkripte von Earnings Calls
• Aktien- & Kryptomarktdaten: Aktienhandel, Kryptohandelsdaten, Nachrichten, Pressemitteilungen, Eigentumsverhältnisse und Bestände

✅ octagon-deep-research-agent für umfassende Deep-Research

• Multi-Source-Synthese für Investment-Recherchefragen
• Optimal für aktuelle, quellenübergreifende thematische Analysen

✅ Prognosemarkt-Recherche-Tooling

• octagon-prediction-markets-agent für aktualisierte Research-Berichte zu einzelnen Prognosemärkten
• prediction_markets_history für strukturierten Abruf historischer Marktdaten

✅ Live-Zugriff auf die Octagon-Dokumentation

• octagon-docs-search, octagon-docs-read, octagon-docs-list und octagon-docs-refresh
• MCP-Ressourcen für octagon-docs://catalog, octagon-docs://status und octagon-docs://page/{target}

So erhalten Sie Ihren Octagon API Key

Um Octagon MCP zu nutzen, müssen Sie:

1. Ein kostenloses Konto bei Octagon erstellen
2. Nach der Anmeldung im linken Menü zu API Keys navigieren
3. Einen neuen API Key generieren
4. Diesen API Key in Ihrer Konfiguration als Wert für OCTAGON_API_KEY verwenden

Voraussetzungen

Vor der Installation oder Ausführung von Octagon MCP muss npx (im Lieferumfang von Node.js und npm enthalten) auf Ihrem System installiert sein.

Mac (macOS)

1. Homebrew installieren (falls nicht vorhanden):

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. Node.js installieren (enthält npm und npx):

   brew install node
   

   Dies installiert die neueste Version von Node.js, npm und npx.

3. Installation überprüfen:

   node -v
   npm -v
   npx -v
   

Windows

1. Node.js-Installer herunterladen:
   • Gehen Sie zu https://nodejs.org/ und laden Sie die LTS-Version für Windows herunter.
2. Installer ausführen und den Anweisungen folgen. Dies installiert Node.js, npm und npx.
3. Installation überprüfen: Eingabeaufforderung öffnen und ausführen:

   node -v
   npm -v
   npx -v
   

Wenn Sie für alle drei Versionsnummern sehen, können Sie mit den folgenden Installationsschritten fortfahren.

Installation

Ausführung in Claude Desktop

So konfigurieren Sie Octagon MCP für Claude Desktop:

1. Claude Desktop öffnen
2. Zu Einstellungen > Entwickler > Konfiguration bearbeiten gehen
3. Folgendes zu Ihrer claude_desktop_config.json hinzufügen (Ersetzen Sie your-octagon-api-key durch Ihren Octagon API Key):

{
  "mcpServers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": ["-y", "octagon-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

4. Claude neu starten, damit die Änderungen wirksam werden

Ausführung in Cursor

Cursor Desktop konfigurieren 🖥️ Hinweis: Erfordert Cursor Version 0.45.6+

So konfigurieren Sie Octagon MCP in Cursor:

1. Cursor-Einstellungen öffnen
2. Zu Funktionen > MCP-Server gehen
3. Auf „+ Neuen MCP-Server hinzufügen“ klicken
4. Folgendes eingeben:
   • Name: „octagon-mcp“ (oder ein bevorzugter Name)
   • Typ: „command“
   • Befehl: env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

Falls Sie Windows verwenden und auf Probleme stoßen, versuchen Sie cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"

Ersetzen Sie your-octagon-api-key durch Ihren Octagon API Key.

Nach dem Hinzufügen die MCP-Serverliste aktualisieren, um die neuen Tools zu sehen. Der Composer-Agent verwendet Octagon MCP automatisch, wenn es angebracht ist. Sie können ihn aber auch explizit anfordern, indem Sie Ihre Investment-Recherchebedürfnisse beschreiben. Auf den Composer zugreifen über Befehl+L (Mac), neben dem Absenden-Button „Agent“ auswählen und Ihre Anfrage eingeben.

Ausführung mit npx

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

Manuelle Installation

npm install -g octagon-mcp

Dokumentation

Für eine umfassende Dokumentation zur Nutzung von Octagon-Agenten besuchen Sie bitte unsere offizielle Dokumentation unter: https://octagonai.co/docs/

Die Dokumentation umfasst:

• Detaillierte API-Referenzen
• Agentenspezifische Abfragerichtlinien
• Beispiele und Anwendungsfälle
• Best Practices für die Investment-Recherche

Den aktuellsten Einrichtungsleitfaden für gehostete MCP-Clients finden Sie hier:

• Octagon MCP Server Guide
• Octagon Claude Plugin Guide
• Octagon Agents Guide

Dieser MCP-Server stellt den Live-Dokumentationskorpus auch direkt für MCP-Clients bereit. Der Dokumentationszugriff erfolgt über den öffentlichen Octagon-Dokumentations-LLM-Endpunkt unter https://octagonai.co/docs/llms.txt; es werden keine OCTAGON_API_KEY verwendet oder übertragen.

Verfügbare Tools

Der MCP-Server stellt derzeit die folgenden Tools bereit:

Dokumentations-Tools

Diese Tools stellen die Live-Octagon-Dokumentation innerhalb der MCP-Sitzung bereit. Sie funktionieren bereits, bevor OCTAGON_API_KEY konfiguriert ist, was sie für Einrichtung, Fehlerbehebung und die Erkundung des passenden Octagon-Agenten oder API-Workflows nützlich macht.

octagon-docs-list

Listet Live-Dokumentationsabschnitte und -seiten aus dem Octagon-Dokumentationskorpus auf.

Parameter

• section (String, optional): Nach Dokumentationsabschnitt filtern.
• source (docs, site oder all, optional): Standardmäßig der Dokumentationskorpus.
• limit (Zahl, optional): Maximale Anzahl zurückzugebender Einträge.

octagon-docs-search

Durchsucht die Octagon-API-, Agenten-, MCP- und Plugin-Dokumentation mit Quell-URLs und optionalen Snippets.

Parameter

• query (String, erforderlich): Suchanfrage.
• section (String, optional): Nach Dokumentationsabschnitt filtern.
• source (docs, site oder all, optional): Standardmäßig der Dokumentationskorpus.
• limit (Zahl, optional): Maximale Anzahl zurückzugebender Ergebnisse.
• includeSnippets (Boolean, optional): Übereinstimmende Snippets in die Ergebnisse aufnehmen.

Beispiel:

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

Liest eine Dokumentationsseite oder einen -abschnitt als Markdown anhand von Titel, URL, Pfad oder Katalog-ID.

Parameter

• target (String, erforderlich): Dokumentationstitel, URL, Pfad oder Katalog-ID.
• source (docs, site oder all, optional): Standardmäßig der Dokumentationskorpus.
• maxChars (Zahl, optional): Maximale Anzahl zurückzugebender Markdown-Zeichen.
• preferCachedContent (Boolean, optional): Indizierten Dokumentationskorpus verwenden, falls verfügbar.

Beispiel:

Read the Octagon MCP server guide.

octagon-docs-refresh

Aktualisiert den In-Memory-Dokumentationskatalog von den Live-LLM-freundlichen Dokumentationsendpunkten.

Parameter

• includeSite (Boolean, optional): Auch den breiteren https://octagonai.co/llms.txt-Site-Index aktualisieren.

Dokumentationsressourcen

Clients, die MCP-Ressourcen unterstützen, können außerdem durchsuchen:

• octagon-docs://catalog: Normalisierter Live-Dokumentationskatalog.
• octagon-docs://status: Cache-Status, Quell-Endpunkte und Aktualisierungsmetadaten.
• octagon-docs://page/{target}: Eine Dokumentationsseite oder ein -abschnitt als Markdown.

octagon-agent

Orchestriert Public- und Private-Market-Intelligence-Analysen.

Parameter

• prompt (String, erforderlich): Rechercheanfrage in natürlicher Sprache.
• conversation (String, optional): Bestehende Octagon-Conversation-ID, um einen vorherigen octagon-agent-Thread fortzusetzen. Beim ersten Aufruf weglassen.
• newConversation (Boolean, optional): Wenn true, wird ein neuer Octagon-Thread für den aktiven Sitzungs-/Thread-Anker gestartet. Empfohlen für den ersten Aufruf eines brandneuen sichtbaren Chats in Top-Layer-Hosts wie Claude Desktop.

Thread-basierte Nutzung

octagon-agent ist das einzige MCP-Tool, das Octagon-Conversation-Threading weiterleitet. Es ist ein zustandsbehaftetes Tool und erwartet Sitzungskontinuität. Der MCP löst den Sitzungs-/Thread-Status in dieser Reihenfolge auf:

1. gespeicherte Konversation für die MCP-Transport-Sitzungsidentität, sofern der Transport diese bereitstellt
2. gespeicherte Konversation für die serververwaltete Standard-stdio-Sitzung
3. explizite conversation kann die aktive Sitzungskonversation für diesen Aufruf dennoch überschreiben

Dieses Paket läuft derzeit als stdio MCP-Server. Im stdio-Modus richtet der Server automatisch eine prozesslokale Sitzung für Kontinuität über Aufrufe hinweg ein. Die meisten lokalen Hosts wie Claude Desktop oder Cursor können daher octagon-agent verwenden, ohne zusätzliche Threading-Felder für grundlegendes Follow-up-Verhalten angeben zu müssen.

Wenn ein Top-Layer-Host weiß, dass ein Aufruf der erste eines neuen sichtbaren Chats ist, sollte er newConversation: true übergeben. Dadurch wird explizit jeder gespeicherte Octagon-Thread für den aktiven MCP-Sitzungsanker vor dem Aufruf gelöscht, was veraltete Kontinuität verhindert, wenn ein stdio-Host denselben langlebigen MCP-Prozess über mehrere sichtbare Chats hinweg wiederverwendet.

Das bedeutet, Sie können jedes dieser Muster verwenden:

1. Erster Aufruf: Nur prompt senden
2. MCP-Host die Transport-Sitzungskontinuität bewahren lassen oder sich auf die Standard-stdio-Sitzung verlassen
3. Zweiter Aufruf: entweder
   • die neue prompt in derselben MCP-Sitzung senden, oder
   • denselben stdio-MCP-Prozess weiterverwenden, oder
   • explizit die vorherige conversation übergeben

Die Transport-Sitzungsidentität ist die kanonische Kontinuitätsprimitive für standardkonforme, zustandsbehaftete MCP-Transporte. Für die lokale stdio-Nutzung bietet die serververwaltete Prozesssitzung Standardkontinuität.

Sitzungsidentität und Octagon-Conversation-Identität sind unterschiedliche Konzepte:

• MCP-Sitzungsidentität steuert die serverseitige Kontinuität über Tool-Aufrufe hinweg
• Octagon conversation steuert den aktiven Octagon-Thread innerhalb dieser Sitzung

Das MCP-Ergebnis enthält die Antwort in content und gibt außerdem strukturierte Metadaten für Orchestratoren in structuredContent zurück:

{
  "model": "octagon-agent",
  "text": "Which stock would you like the latest price for?",
  "conversation": "conv_123",
  "responseId": "resp_123",
  "followUp": {
    "required": true,
    "inputTemplate": "<ticker or company name>",
    "instructions": "Reply with just the missing detail and reuse the conversation value from this response."
  }
}

Explizites Carry-Forward-Beispiel:

{
  "prompt": "AAPL",
  "conversation": "conv_123"
}

Beispiel für neuen sichtbaren Chat:

{
  "prompt": "Analyze Apple",
  "newConversation": true
}

Explizites Aktualisierungsbeispiel:

{
  "prompt": "Start a fresh Octagon thread for this chat",
  "newConversation": true
}

Richtlinie für zustandsbehaftete Tools

• octagon-agent: zustandsbehaftet, verwendet einen nutzbaren Kontinuitätsanker. In stdio-Hosts ist das standardmäßig die serververwaltete Prozesssitzung, sofern Sie keine explizite conversation angeben
• andere MCP-Tools: zustandslos und können ohne Sitzungskontinuität ausgeführt werden

Beispiel:

Compare NVIDIA and AMD on latest quarterly revenue growth, margins, and management commentary.

Weitere Beispiele:

• „Wie hoch waren Umsatz und Nettogewinn von Amazon im 4. Quartal 2023?“
• „Analysieren Sie Teslas F&E-Ausgabenentwicklung der letzten 3 Jahre.“
• „Welche Prognose gab NVIDIAs CEO zur KI-Chip-Nachfrage im letzten Earnings Call?“
• „Vergleichen Sie Kurs-Gewinn-, Kurs-Umsatz- und EV/EBITDA-Verhältnisse der Top-5-Halbleiterunternehmen.“
• „Wie hoch waren Größe, Bewertung und Hauptinvestoren der letzten Finanzierungsrunde von Anthropic?“
• „Wie viele Investitionen hat Andreessen Horowitz in den letzten 12 Monaten in KI-Startups getätigt?“
• „Was sind die neuesten Nachrichtenartikel zu NVIDIA-Aktien aus der vergangenen Woche?“

octagon-deep-research-agent

Führt umfassende Multi-Source-Deep-Research und -Synthese durch.

Parameter

• prompt (String, erforderlich): Rechercheanfrage in natürlicher Sprache.

Beispiel:

Research the impact of lower interest rates on late-stage private software valuations over the next 12 months.

Weitere Beispiele:

• „Extrahieren Sie alle Datenfelder von zillow.com/san-francisco-ca/“
• „Recherchieren Sie die finanziellen Auswirkungen von Apples Datenschutzänderungen auf Umsatz und Margen von Digitalwerbeunternehmen“
• „Rufen Sie historische Bitcoin-Preisdaten von 2023 ab und analysieren Sie die Preisvolatilitätstrends“
• „Analysieren Sie die Wettbewerbsdynamik im Markt für Ladeinfrastruktur von Elektrofahrzeugen“

octagon-prediction-markets-agent

Erstellt Research-Berichte für Kalshi-Prognosemarktereignisse.

Parameter

• prompt (String, erforderlich): Rechercheanfrage in natürlicher Sprache.
• cache (Boolean, optional): Steuert das Agentenvarianten-Routing.
  • weggelassen: prediction-markets-agent
  • false: prediction-markets-agent:refresh
  • true: prediction-markets-agent:cache

Beispiel:

Generate a report for the Kalshi market https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

prediction_markets_history

Ruft historische Daten für ein Prognosemarktereignis-Ticker mit optionaler Paginierung und Zeitfiltern ab.

Parameter

• event_ticker (String, erforderlich)
• limit (Zahl, optional)
• cursor (String, optional)
• captured_from (String, optional)
• captured_to (String, optional)
• include_analysis (Boolean, optional; wenn true, werden Analysesparten angefordert)

Beispiel:

Fetch historical data for the Kalshi event https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

Fehlerbehebung

1. API-Schlüssel-Probleme: Stellen Sie sicher, dass Ihr Octagon-API-Schlüssel korrekt in der Umgebung oder Konfigurationsdatei gesetzt ist.
2. Verbindungsprobleme: Stellen Sie sicher, dass die Verbindung zur Octagon-API ordnungsgemäß funktioniert.
3. Ratenbegrenzung: Wenn Sie auf Fehler durch Ratenbegrenzung stoßen, reduzieren Sie die Häufigkeit Ihrer Anfragen.

Lizenz

MIT

Einzelne spezialisierte MCP-Server

Während dieser Server umfassende Marktinformationen bietet, die alle unsere spezialisierten Agenten kombinieren, können Sie auch unsere einzelnen MCP-Server für spezifische Anwendungsfälle nutzen:

Recherche-Tools

• Octagon Deep Research MCP - Umfassende Recherche- und Web-Scraping-Funktionen

---

⭐ Vergeben Sie einen Stern für dieses Repo, wenn Sie es hilfreich finden!