CryptoStruct
officielServeur MCP distant pour données historiques de crypto et de marchés prédictifs : recherche de ~500 000 instruments, statistiques de marché en direct (OHLC, volume, écarts, profondeur, glissement) et achat de données tick. Sans clé pour le catalogue et les statistiques ; OAuth facultatif pour les outils de compte. Point de terminaison : https://cryptostruct.com/mcp
Que pouvez-vous faire avec CryptoStruct MCP ?
- Rechercher dans le catalogue d’instruments — Interrogez les instruments sur 35 plateformes, y compris les marchés de prédiction, à l’aide de
search_instrumentsavec des filtres commeclass=prediction. - Obtenir des instantanés de marché en direct — Demandez les OHLC actuels, le VWAP, les spreads et la profondeur du carnet d’ordres pour tout instrument via
get_market_snapshot. - Analyser les agrégats historiques — Récupérez des statistiques quotidiennes, horaires ou par minute (par ex.,
get_daily_stats,get_hourly_stats) pour des études d’événements ou des analyses de tendances. - Vérifier la couverture des archives — Confirmez la disponibilité des données au niveau journalier pour un instrument jusqu’en 2021 à l’aide de
get_coverage. - Prévisualiser et démarrer les achats — Utilisez
preview_checkoutpour simuler un achat de données, puiscreate_checkoutpour obtenir une URL Stripe ou déclencher une approbation de crédit. - Gérer votre compte — Listez les commandes passées, récupérez les téléchargements de fichiers achetés et vérifiez votre abonnement ou votre solde de crédit avec
list_my_ordersetget_my_subscription.
Documentation
Serveur MCP CryptoStruct
Serveur MCP distant propriétaire pour cryptostruct.com — données historiques de crypto et de marchés prédictifs (fichiers journaliers au niveau des ticks provenant de 35 plateformes, dont Kalshi et Polymarket) ainsi que des statistiques de marché en direct, conçu pour les traders, les quants et les agents IA.
Ce dépôt documente le serveur hébergé. Il n'y a rien à installer ni à exécuter depuis ici — le serveur est exploité par CryptoStruct.
- Point de terminaison :
https://cryptostruct.com/mcp(HTTP Streamable, sans état, mode JSON) - Point de terminaison OAuth :
https://cryptostruct.com/mcp/auth(mêmes outils ; répond à401+WWW-Authenticatepour déclencher le flux OAuth standard — Dynamic Client Registration + PKCE) - Carte serveur :
/.well-known/mcp/server-card.json - Documentation : https://cryptostruct.com/docs/mcp · Documentation produit : https://docs.cryptostruct.com
Aucune clé API requise — le catalogue, les statistiques de marché et le flux d'achat invité fonctionnent sans clé. La connexion via OAuth (facultative) lie votre compte CryptoStruct pour l'historique des commandes, les téléchargements de fichiers achetés et le paiement avec vos crédits — toujours avec votre consentement (voir Achat de données).
Démarrage rapide
Claude Code
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
# or, to enable account sign-in via OAuth:
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp/auth
Cursor / configuration JSON générique
{
"mcpServers": {
"cryptostruct": {
"url": "https://cryptostruct.com/mcp"
}
}
}
claude.ai — Paramètres → Connecteurs → Ajouter un connecteur personnalisé → https://cryptostruct.com/mcp/auth
Ce que vous pouvez faire
- Catalogue et découverte : recherchez environ 500 000 instruments sur 35 plateformes (spot, perpétuels, contrats à terme, options, marchés prédictifs), avec une couverture d'archives journalières remontant au 2021-02-08.
- Marchés prédictifs : les contrats d'événements Kalshi et Polymarket sont des instruments de première classe — recherchables dans le catalogue (
class=prediction), avec couverture, instantanés en direct et agrégats minute/quotidiens comme tout instrument crypto. Les contrats sont cotés de 0 à 1 (USD) ; le volume d'échange est normalisé en USD. - Statistiques de marché : instantanés en direct et agrégats minute/horaire/quotidiens — OHLC, VWAP, transactions, volume d'échange, spreads, profondeur du carnet d'ordres ; courbes de glissement / impact sur le marché.
- Achat de données : fichiers de ticks bruts — instruments crypto et marchés prédictifs confondus — coûtent 1 € par instrument-jour. Paiement par carte : le serveur transmet une URL de paiement Stripe — le paiement s'effectue dans le navigateur de l'utilisateur, le serveur ne touche jamais aux données de carte. Des fichiers d'échantillons gratuits d'une journée complète sont disponibles sans aucun achat.
- Crédits et consentement de l'agent (connexion OAuth) : les crédits du compte ne sont jamais dépensés par un agent sans le consentement de l'utilisateur. Par défaut,
create_checkoutrépond àapproval_requiredavec une page d'approbation où l'utilisateur confirme (paiement par crédits ou par carte) ou rejette la commande ; les commandes non approuvées expirent après 24 h sans aucun débit. Les utilisateurs peuvent opter pour des achats autonomes dans les limites (plafonds par commande et glissants sur 24 heures) à https://cryptostruct.com/account/agents — les commandes entièrement couvertes par les crédits sont alors exécutées immédiatement ; tout ce qui dépasse les plafonds revient pour approbation. L'agent peut également transmettre son propremax_credit_cents.preview_checkoutindique à l'agent à l'avance lequel des trois résultats attendre. Ces paramètres ne peuvent être modifiés que sur le site web, jamais via le jeton d'un agent. - Outils de compte (connexion OAuth) : lister les commandes, obtenir les URL de téléchargement des fichiers achetés, vérifier l'abonnement, le solde de crédits et les paramètres de dépenses de l'agent.
Outils
| Outil | Description | Niveau |
|---|---|---|
get_data_dictionary | Dictionnaire de données et référence produit (format de fichier, unités, tarification) | gratuit |
search_instruments | Rechercher dans le catalogue d'instruments | gratuit |
list_venues | Lister les plateformes couvertes | gratuit |
get_instrument | Détails d'un instrument | gratuit |
get_coverage | Couverture d'archives journalières pour un instrument | gratuit |
list_sample_files | Fichiers d'échantillons gratuits d'une journée complète | gratuit |
get_price_quote | Devis de prix pour un ensemble de fichiers de données | gratuit |
get_market_snapshot | Instantané de marché en direct (60 min + 24 h) | gratuit |
get_daily_stats | Agrégats quotidiens (30 j–180 j gratuits ; 365 j/max Premium) | gratuit |
get_hourly_stats | Agrégats horaires (7 j–90 j gratuits ; 180 j Premium) | gratuit |
get_slippage | Courbe de glissement / impact sur le marché (1 h gratuite ; 24 h/7 j Premium) | gratuit |
get_top_instruments | Principaux instruments par volume d'échange sur 24 h en direct | gratuit |
get_movers | Mouvements sur 24 h (hausses et baisses) | gratuit |
get_minutes_range | Série historique minute pour études d'événements | premium |
create_checkout | Démarrer un achat — URL Stripe (carte) ou approval_required / né payé (crédits, selon les paramètres de consentement de l'utilisateur) | commerce |
get_checkout_status | Interroger un paiement par session_id (carte) ou order_id (connecté ; commandes crédit/approbation) | commerce |
get_order_files | Lister les fichiers d'une commande payée avec URL de téléchargement | commerce |
request_file_restore | Restaurer un fichier archivé (stockage à froid) | commerce |
list_my_orders | Mes commandes | connexion |
get_my_files | Mes fichiers achetés | connexion |
get_my_subscription | Mon abonnement, solde de crédits et paramètres de dépenses de l'agent | connexion |
preview_checkout | Essai à blanc d'un achat : fichiers possédés/indisponibles, couverture par crédits, et si create_checkout sera exécuté, demandera une approbation, ou sera transmis à Stripe | connexion |
Niveaux : free/commerce fonctionnent sans clé. sign-in nécessite une connexion OAuth vérifiée (n'importe quel compte). Les outils/paramètres premium nécessitent CryptoStruct Premium (20 €/mois) — ce qui débloque également des fenêtres de statistiques plus longues (quotidien 365 j/max, horaire 180 j, glissement 24 h/7 j), des limites de recherche plus élevées, un bloc de qualité des données dans get_market_snapshot, et un budget d'appels 5×. Les appels au-delà de votre niveau renvoient des erreurs statiques AUTH_REQUIRED / PREMIUM_REQUIRED avec une URL de mise à niveau — jamais un échec définitif.
Limites de débit
Budget pondéré par appelant : 120 unités/min sans clé (par IP) ou par utilisateur connecté, 600 unités/min pour Premium. Les lectures de catalogue peu coûteuses coûtent 1 unité, les statistiques lourdes en amont 3–5, le paiement 10. En cas d'erreurs RATE_LIMITED, patientez le nombre de secondes indiqué.
Conventions
- Toutes les tailles de fichiers sont en octets compressés (zstd) ; les valeurs de marché sont en USD ; les prix de vente sont en EUR.
- Les données à granularité minute sont conservées ~30 jours en amont ; les agrégats horaires/quotidiens remontent plus loin.
- Les fichiers de ticks sont des captures JSON-lines d'une journée complète (instantanés et mises à jour du carnet d'ordres, transactions, liquidations, financement, mark/index incluant les grecques des options). Référence de format : Market Data Protocol.
Liens connexes
- Compétence d'agent pour analyser les fichiers de ticks :
cryptostruct-market-data(zip) - Index de découverte des compétences :
/.well-known/agent-skills/index.json - Catalogue API (RFC 9727) :
/.well-known/api-catalog llms.txt: https://cryptostruct.com/llms.txt
Support
Questions ou problèmes : https://cryptostruct.com/contact