Octagon

Octagon : MCP pour l'intelligence des marchés publics et prédictifs

Le serveur MCP Octagon fournit une recherche et une analyse financières spécialisées, alimentées par l'IA, en s'intégrant à l'API Octagon Market Intelligence, permettant aux utilisateurs d'analyser et d'extraire des informations des dépôts publics, des appels de résultats, des indicateurs financiers, des données boursières et crypto, de l'actualité boursière, et de l'actualité et de la recherche sur les marchés prédictifs dans Claude Desktop et d'autres clients MCP populaires.

Outils

✅ octagon-agent orchestre une analyse large de l'intelligence de marché

• Perspectives des marchés publics : dépôts SEC (10-K, 10-Q, 20-F, 8-K, S-1, 13-F, DEF 14A), transcriptions d'appels de résultats
• Données des marchés boursiers et crypto : données de trading d'actions, de trading crypto, actualités, communiqués de presse, participations et avoirs

✅ octagon-deep-research-agent pour une recherche approfondie complète

• Synthèse multi-sources pour les questions de recherche en investissement
• Idéal pour une analyse thématique actualisée et transversale

✅ Outils de recherche sur les marchés prédictifs

• octagon-prediction-markets-agent pour des rapports de recherche mis à jour sur chaque marché prédictif
• prediction_markets_history pour la récupération structurée de données historiques de marché

✅ Accès en direct à la documentation Octagon

• octagon-docs-search, octagon-docs-read, octagon-docs-list, et octagon-docs-refresh
• Ressources MCP pour octagon-docs://catalog, octagon-docs://status, et octagon-docs://page/{target}

Obtenez votre clé API Octagon

Pour utiliser Octagon MCP, vous devez :

1. Créer un compte gratuit sur Octagon
2. Après connexion, depuis le menu de gauche, accédez à API Keys
3. Générez une nouvelle clé API
4. Utilisez cette clé API dans votre configuration comme valeur OCTAGON_API_KEY

Prérequis

Avant d'installer ou d'exécuter Octagon MCP, vous devez avoir npx (qui est fourni avec Node.js et npm) installé sur votre système.

Mac (macOS)

1. Installez Homebrew (si vous ne l'avez pas) :

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

2. Installez Node.js (inclut npm et npx) :

   brew install node
   

   Cela installera la dernière version de Node.js, npm et npx.

3. Vérifiez l'installation :

   node -v
   npm -v
   npx -v
   

Windows

1. Téléchargez l'installateur Node.js :
   • Allez sur https://nodejs.org/ et téléchargez la version LTS pour Windows.
2. Exécutez l'installateur et suivez les instructions. Cela installera Node.js, npm et npx.
3. Vérifiez l'installation : Ouvrez l'invite de commandes et exécutez :

   node -v
   npm -v
   npx -v
   

Si vous voyez des numéros de version pour les trois, vous êtes prêt à procéder aux étapes d'installation ci-dessous.

Installation

Exécution sur Claude Desktop

Pour configurer Octagon MCP pour Claude Desktop :

1. Ouvrez Claude Desktop
2. Allez dans Paramètres > Développeur > Modifier la configuration
3. Ajoutez ce qui suit à votre claude_desktop_config.json (Remplacez your-octagon-api-key par votre clé API Octagon) :

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

4. Redémarrez Claude pour que les modifications prennent effet

Exécution sur Cursor

Configuration de Cursor Desktop 🖥️ Note : Nécessite Cursor version 0.45.6+

Pour configurer Octagon MCP dans Cursor :

1. Ouvrez les paramètres de Cursor
2. Allez dans Fonctionnalités > Serveurs MCP
3. Cliquez sur "+ Ajouter un nouveau serveur MCP"
4. Entrez les informations suivantes :
   • Nom : "octagon-mcp" (ou le nom de votre choix)
   • Type : "command"
   • Commande : env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

Si vous utilisez Windows et rencontrez des problèmes, essayez cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"

Remplacez your-octagon-api-key par votre clé API Octagon.

Après l'ajout, actualisez la liste des serveurs MCP pour voir les nouveaux outils. L'Agent Composer utilisera automatiquement Octagon MCP lorsque cela est approprié, mais vous pouvez le demander explicitement en décrivant vos besoins de recherche en investissement. Accédez au Composer via Commande+L (Mac), sélectionnez "Agent" à côté du bouton d'envoi, et entrez votre requête.

Exécution avec npx

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

Installation manuelle

npm install -g octagon-mcp

Documentation

Pour une documentation complète sur l'utilisation des agents Octagon, veuillez consulter notre documentation officielle à l'adresse : https://octagonai.co/docs/

La documentation inclut :

• Références API détaillées
• Directives de requête spécifiques aux agents
• Exemples et cas d'utilisation
• Meilleures pratiques pour la recherche en investissement

Pour le dernier guide de configuration du client MCP hébergé, consultez :

• Guide du serveur MCP Octagon
• Guide du plugin Claude Octagon
• Guide des agents Octagon

Ce serveur MCP expose également le corpus de documentation en direct directement aux clients MCP. L'accès à la documentation est récupéré depuis le point d'entrée LLM public des documents Octagon à https://octagonai.co/docs/llms.txt ; il n'utilise ni ne transmet OCTAGON_API_KEY.

Outils disponibles

Le serveur MCP expose actuellement les outils suivants :

Outils de documentation

Ces outils exposent la documentation Octagon en direct dans la session MCP. Ils fonctionnent même avant que OCTAGON_API_KEY ne soit configuré, ce qui les rend utiles pour la configuration, le dépannage et la découverte de l'agent ou du flux de travail API Octagon approprié.

octagon-docs-list

Liste les sections et pages de documentation en direct du corpus de documents Octagon.

Paramètres

• section (chaîne, optionnel) : filtrer par section de documentation.
• source (docs, site, ou all, optionnel) : par défaut, le corpus de documentation.
• limit (nombre, optionnel) : nombre maximum d'entrées à retourner.

octagon-docs-search

Recherche dans la documentation de l'API Octagon, des agents, du MCP et des plugins avec les URL sources et des extraits optionnels.

Paramètres

• query (chaîne, requis) : requête de recherche.
• section (chaîne, optionnel) : filtrer par section de documentation.
• source (docs, site, ou all, optionnel) : par défaut, le corpus de documentation.
• limit (nombre, optionnel) : nombre maximum de résultats à retourner.
• includeSnippets (booléen, optionnel) : inclure les extraits correspondants dans les résultats.

Exemple :

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

Lit une page ou section de documentation en Markdown par titre, URL, chemin ou identifiant de catalogue.

Paramètres

• target (chaîne, requis) : titre, URL, chemin ou identifiant de catalogue de la documentation.
• source (docs, site, ou all, optionnel) : par défaut, le corpus de documentation.
• maxChars (nombre, optionnel) : nombre maximum de caractères Markdown à retourner.
• preferCachedContent (booléen, optionnel) : utiliser le corpus de documentation indexé lorsqu'il est disponible.

Exemple :

Read the Octagon MCP server guide.

octagon-docs-refresh

Actualise le catalogue de documentation en mémoire à partir des points de terminaison de documentation en direct adaptés aux LLM.

Paramètres

• includeSite (booléen, optionnel) : actualiser également l'index plus large du site https://octagonai.co/llms.txt.

Ressources de documentation

Les clients qui prennent en charge les ressources MCP peuvent également parcourir :

• octagon-docs://catalog : catalogue de documentation en direct normalisé.
• octagon-docs://status : état du cache, points de terminaison sources et métadonnées d'actualisation.
• octagon-docs://page/{target} : une page ou section de documentation en Markdown.

octagon-agent

Orchestre l'analyse de l'intelligence de marché publique et privée.

Paramètres

• prompt (chaîne, requis) : demande de recherche en langage naturel.
• conversation (chaîne, optionnel) : identifiant de conversation Octagon existant pour continuer un fil octagon-agent antérieur. Omettez-le au premier tour.
• newConversation (booléen, optionnel) : si true, démarre un nouveau fil Octagon pour l'ancre de session/fil actif. Recommandé pour le premier tour d'un nouveau chat visible dans les hôtes de niveau supérieur tels que Claude Desktop.

Utilisation en fil de discussion

octagon-agent est le seul outil MCP qui transmet le fil de conversation Octagon. C'est un outil avec état et il attend une continuité de session. Le MCP résout l'état de session/fil dans cet ordre :

1. conversation stockée pour l'identité de session de transport MCP, lorsque le transport la fournit effectivement
2. conversation stockée pour la session stdio par défaut gérée par le serveur
3. un conversation explicite peut toujours remplacer la conversation de session active pour cet appel

Ce package s'exécute actuellement comme un serveur MCP stdio. En mode stdio, le serveur établit automatiquement une session locale au processus pour la continuité entre les appels. La plupart des hôtes locaux tels que Claude Desktop ou Cursor peuvent donc utiliser octagon-agent sans fournir de champs de fil supplémentaires pour un comportement de suivi de base.

Lorsqu'un hôte de niveau supérieur sait qu'un appel est le premier tour d'un nouveau chat visible, il doit passer newConversation: true. Cela efface explicitement tout fil Octagon stocké pour l'ancre de session MCP active avant l'appel, ce qui empêche une continuité périmée lorsqu'un hôte stdio réutilise le même processus MCP de longue durée à travers plusieurs chats visibles.

Cela signifie que vous pouvez utiliser l'un de ces modèles :

1. Premier appel : envoyez uniquement prompt
2. Laissez l'hôte MCP préserver la continuité de session de transport ou reposez-vous sur la session stdio par défaut
3. Deuxième appel : soit
   • envoyez le nouveau prompt dans la même session MCP, soit
   • continuez à utiliser le même processus MCP stdio, soit
   • passez explicitement le conversation précédent

L'identité de session de transport est la primitive de continuité canonique pour les transports MCP avec état conformes aux normes. Pour une utilisation locale stdio, la session de processus gérée par le serveur fournit une continuité par défaut.

L'identité de session et l'identité de conversation Octagon sont des concepts différents :

• L'identité de session MCP contrôle la continuité côté serveur entre les appels d'outils
• L'conversation Octagon contrôle le fil Octagon actif à l'intérieur de cette session

Le résultat MCP conserve la réponse dans content, et retourne également des métadonnées structurées pour les orchestrateurs dans structuredContent :

{
  "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."
  }
}

Exemple de report explicite :

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

Exemple de nouveau chat visible :

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

Exemple d'actualisation explicite :

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

Politique des outils avec état

• octagon-agent : avec état, utilise une ancre de continuité utilisable. Dans les hôtes stdio, cela utilise par défaut la session de processus gérée par le serveur sauf si vous fournissez un conversation explicite
• autres outils MCP : sans état et peuvent s'exécuter sans continuité de session

Exemple :

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

Plus d'exemples :

• "Quels étaient les chiffres de revenus et de bénéfice net d'Amazon au T4 2023 ?"
• "Analysez les tendances des dépenses R&D de Tesla au cours des 3 dernières années."
• "Quelles orientations le PDG de NVIDIA a-t-il fournies concernant la demande de puces IA lors de leur dernier appel de résultats ?"
• "Comparez les ratios cours/bénéfice, cours/ventes et EV/EBITDA pour les 5 principales entreprises de semi-conducteurs."
• "Quelle était la taille, la valorisation et les investisseurs clés du dernier tour de financement d'Anthropic ?"
• "Combien d'investissements Andreessen Horowitz a-t-il réalisés dans des startups IA au cours des 12 derniers mois ?"
• "Quels sont les derniers articles d'actualité pour l'action NVIDIA de la semaine dernière ?"

octagon-deep-research-agent

Effectue une recherche approfondie et une synthèse complètes multi-sources.

Paramètres

• prompt (chaîne, requis) : demande de recherche en langage naturel.

Exemple :

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

Plus d'exemples :

• "Extrayez tous les champs de données de zillow.com/san-francisco-ca/"
• "Recherchez l'impact financier des changements de confidentialité d'Apple sur les revenus et les marges des entreprises de publicité numérique"
• "Récupérez les données historiques du prix du Bitcoin de 2023 et analysez les tendances de volatilité des prix"
• "Analysez la dynamique concurrentielle sur le marché des infrastructures de recharge pour véhicules électriques"

octagon-prediction-markets-agent

Génère des rapports de recherche pour les événements du marché prédictif Kalshi.

Paramètres

• prompt (chaîne, requis) : demande de recherche en langage naturel.
• cache (booléen, optionnel) : contrôle le routage de la variante d'agent.
  • omis : prediction-markets-agent
  • false : prediction-markets-agent:refresh
  • true : prediction-markets-agent:cache

Exemple :

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

prediction_markets_history

Récupère les données historiques pour un ticker d'événement de marché prédictif avec pagination et filtres temporels optionnels.

Paramètres

• event_ticker (chaîne, requis)
• limit (nombre, optionnel)
• cursor (chaîne, optionnel)
• captured_from (chaîne, optionnel)
• captured_to (chaîne, optionnel)
• include_analysis (booléen, optionnel ; lorsque vrai, demande des colonnes d'analyse)

Exemple :

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

Dépannage

1. Problèmes de clé API : Assurez-vous que votre clé API Octagon est correctement définie dans l'environnement ou le fichier de configuration.
2. Problèmes de connexion : Vérifiez que la connectivité à l'API Octagon fonctionne correctement.
3. Limitation de débit : Si vous rencontrez des erreurs de limitation de débit, réduisez la fréquence de vos requêtes.

Licence

MIT

Serveurs MCP spécialisés individuels

Bien que ce serveur fournisse une intelligence de marché complète combinant tous nos agents spécialisés, vous pouvez également utiliser nos serveurs MCP individuels pour des cas d'usage spécifiques :

Outils de recherche

• Octagon Deep Research MCP - Capacités complètes de recherche et de web scraping

---

⭐ Mettez une étoile à ce dépôt si vous le trouvez utile !