Bitculator
Serveur MCP Bitculator

Des données crypto en direct pour votre assistant IA

Le serveur MCP de Bitculator expose la Data API sous forme de 19 outils sélectionnés, en lecture seule, via le Model Context Protocol ouvert. Connectez-vous une fois et votre assistant répond avec les prix en direct, l'historique, le sentiment et l'intelligence des exchanges.

Endpoint
https://bitculator.com/mcp
Transport
Streamable HTTP
Authentification
Clé API Bearer
Outils
19 · lecture seule

MCP (Model Context Protocol) est le standard ouvert que les clients IA utilisent pour atteindre des outils externes. Tout client prenant en charge les serveurs distants via Streamable HTTP peut utiliser Bitculator - les sections ci-dessous couvrent les plus répandus. Tous les prix, taux, capitalisations et offres sont renvoyés en chaînes décimales pour préserver la précision, exactement comme l'API REST.

Authentification

Le serveur s'authentifie avec les mêmes clés que la Data API : créez une clé dotée de l'aptitude data-api dans la console développeur (le forfait gratuit suffit - aucune carte requise) et envoyez-la en en-tête Bearer sur chaque requête. Les clés embed sont rejetées.

En-tête HTTP
Authorization: Bearer YOUR_API_KEY

Les requêtes sans clé valide reçoivent 401 unauthenticated. Les clés sont des secrets - configurez-les dans les réglages de votre client ou une variable d'environnement, jamais dans des fichiers partagés que vous committez.

Claude Code

Une seule commande enregistre le serveur pour votre projet (ou ajoutez --scope user pour le rendre disponible partout). Claude choisit automatiquement le bon outil quand vous l'interrogez sur le marché.

terminal
claude mcp add --transport http bitculator \
    https://bitculator.com/mcp \
    --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Ajoutez le serveur à ~/.cursor/mcp.json (global) ou .cursor/mcp.json dans un projet. Les outils apparaissent dans l'agent de Cursor dès que le fichier est enregistré.

~/.cursor/mcp.json
{
  "mcpServers": {
    "bitculator": {
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

Ajoutez le serveur à .vscode/mcp.json dans votre espace de travail. Le mode agent de GitHub Copilot liste automatiquement les outils Bitculator.

.vscode/mcp.json
{
  "servers": {
    "bitculator": {
      "type": "http",
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude API

Vous construisez votre propre app sur l'API Anthropic ? Le connecteur MCP atteint le serveur directement depuis un appel à la Messages API - passez votre clé Bitculator comme authorization_token.

POST /v1/messages
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "mcp_servers": [{
      "type": "url",
      "url": "https://bitculator.com/mcp",
      "name": "bitculator",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "bitculator" }],
    "messages": [{ "role": "user", "content": "How is the crypto market today?" }]
  }'

ChatGPT

ChatGPT se connecte aux serveurs MCP distants via le mode développeur :

  1. Activez le mode développeur dans les réglages de ChatGPT (Apps & Connectors → Advanced).
  2. Ajoutez un connecteur avec l'URL de serveur https://bitculator.com/mcp.
  3. L'authentification des connecteurs de ChatGPT repose sur OAuth - les en-têtes de clé API n'y sont pas encore pris en charge ; utilisez donc un client capable de fonctionner sans auth ou les surfaces Claude pour un accès par clé.

Un flux OAuth (et avec lui la prise en charge complète des annuaires ChatGPT + Claude) est sur la feuille de route. Les clients à clé - Claude Code, Cursor, VS Code, la Claude API - fonctionnent dès aujourd'hui.

Quota & limites

MCP est une surface de consommation de la Data API - il n'y a ni facture ni pool MCP séparés.

  • Chaque appel d'outil compte comme une requête Data API sur le quota mensuel de votre forfait.
  • La limite de rafale par minute de votre forfait s'applique par appel d'outil (Free 30, Starter 60, Pro 120).
  • Au-delà du quota, les outils renvoient une erreur rate_limited qui indique à l'assistant quand le pool se réinitialise. Les endpoints réservés à certains forfaits renvoient plan_required.
  • La poignée de main du protocole (initialize, tools/list) est gratuite - seuls les appels d'outils puisent dans le pool.

Frameworks d'agents

Vous construisez votre propre agent ? Chaque grand framework embarque un client MCP qui se connecte en Streamable HTTP avec un en-tête Bearer - les extraits ci-dessous chargent les 19 outils comme des fonctions natives.

OpenAI Agents SDK

pip install openai-agents
Python
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="Bitculator",
    params={"url": "https://bitculator.com/mcp",
            "headers": {"Authorization": "Bearer YOUR_API_KEY"}},
) as server:
    agent = Agent(name="analyst", mcp_servers=[server])

Vercel AI SDK

npm i @ai-sdk/mcp
TypeScript
import { createMCPClient } from '@ai-sdk/mcp';

const mcp = await createMCPClient({
  transport: {
    type: 'http',
    url: 'https://bitculator.com/mcp',
    headers: { Authorization: 'Bearer YOUR_API_KEY' },
  },
});
const tools = await mcp.tools();

LangChain

pip install langchain-mcp-adapters
Python
from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({"bitculator": {
    "transport": "http",
    "url": "https://bitculator.com/mcp",
    "headers": {"Authorization": "Bearer YOUR_API_KEY"},
}})
tools = await client.get_tools()

LlamaIndex

pip install llama-index-tools-mcp
Python
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

client = BasicMCPClient("https://bitculator.com/mcp",
                        headers={"Authorization": "Bearer YOUR_API_KEY"})
tools = await McpToolSpec(client=client).to_tool_list_async()

Mastra

npm i @mastra/mcp
TypeScript
import { MCPClient } from '@mastra/mcp';

const mcp = new MCPClient({ servers: { bitculator: {
    url: new URL('https://bitculator.com/mcp'),
    requestInit: { headers: { Authorization: 'Bearer YOUR_API_KEY' } },
}}});
const tools = await mcp.getTools();

Semantic Kernel

pip install semantic-kernel[mcp]
Python
from semantic_kernel.connectors.mcp import MCPStreamableHttpPlugin

async with MCPStreamableHttpPlugin(
    name="Bitculator",
    url="https://bitculator.com/mcp",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
) as plugin:
    kernel.add_plugin(plugin)

Référence des outils

Les 19 outils sont tous en lecture seule. Les paramètres reflètent les endpoints Data API correspondants - même validation, mêmes restrictions de forfait, même précision en chaînes décimales.

Données de marché

Outil

search_coins

Résout un coin ou un token par nom en texte libre ou par symbole vers son slug canonique, avec un résumé de marché classé pour chaque correspondance. Le point d'entrée : tous les autres outils coin s'adressent par slug.

Paramètre Type Description
query requis string Recherche en texte libre, comparée aux noms et symboles des coins.
type enum Restreint les correspondances : coin ou token.
limit integer Nombre maximal de correspondances à renvoyer (1–50, 10 par défaut).
Outil

get_coin

Profil complet d'un coin : offres, rang et variations de rang, plus haut/plus bas historiques et distance à ceux-ci, valorisation entièrement diluée, liens, contrats et description.

Paramètre Type Description
slug requis string Slug canonique du coin, p. ex. bitcoin.
Outil

get_prices

Prix spot actuels de jusqu'à 100 coins en un appel, éventuellement convertis dans une devise fiat. Le moyen le moins coûteux de répondre aux questions de prix - exactement un sélecteur est requis.

Paramètre Type Description
slugs string Slugs de coins séparés par des virgules - le sélecteur à privilégier.
symbols string Symboles ticker séparés par des virgules ; les symboles ambigus se résolvent vers la correspondance la mieux classée.
ids string Ids numériques Bitculator de coins, séparés par des virgules.
convert string Symbole de la devise fiat dans laquelle convertir les prix, p. ex. EUR. USD par défaut.
Outil

get_top_movers

Les plus fortes hausses ou baisses en variation en pourcentage sur les dernières 24 heures ou les 7 derniers jours.

Paramètre Type Description
direction requis enum gainers ou losers.
interval enum Fenêtre de variation pour le classement : 24h ou 7d (24h par défaut).
limit integer Nombre maximal de coins à renvoyer (1–50, 10 par défaut).

Historique

Outil

get_price_history

Bougies OHLCV d'un coin sur une plage de dates. Rétention : à la minute ~8 jours, à la demi-heure ~3 mois, à l'heure ~6 mois, quotidien = historique complet. Renvoie les bougies les plus récentes de la fenêtre, les plus anciennes d'abord.

Paramètre Type Description
slug requis string Slug canonique du coin.
interval enum Intervalle des bougies : minutely, half-hourly, hourly ou daily (daily par défaut).
start date Début de la fenêtre au format YYYY-MM-DD ; par défaut, une fenêtre récente adaptée à l'intervalle.
end date Fin de la fenêtre au format YYYY-MM-DD ; maintenant par défaut.
limit integer Nombre maximal de bougies à renvoyer (1–500, 90 par défaut).
Outil

get_historical_price

Le prix d'un coin à une date passée précise, avec jusqu'à 3 jours de repli quand le jour exact n'a pas de données.

Paramètre Type Description
slug requis string Slug canonique du coin.
date requis date La date au format YYYY-MM-DD (2009-01-01 ou plus tard, pas dans le futur).
Outil

get_global_history

Série temporelle de la capitalisation totale du marché crypto ou du volume total. La granularité suit la période : 24h à la demi-heure, 7d à l'heure, 30d et all au quotidien.

Paramètre Type Description
metric requis enum Quelle série renvoyer : marketcap ou volume.
period enum Fenêtre : 24h, 7d, 30d ou all (24h par défaut).

Sentiment & global

Outil

get_global_market

Instantané du marché entier : capitalisation totale, volume total sur 24 h, dominance BTC/ETH et décomptes de coins/tokens/exchanges/paires.

Cet outil ne prend aucun paramètre.

Outil

get_fear_greed

L'indice de sentiment Fear & Greed pour le marché entier, ou pour un coin quand un slug est passé, avec les sous-scores d'intervalle 7d/30d.

Paramètre Type Description
coin string Slug de coin optionnel pour une lecture par coin ; omettez-le pour l'indice du marché entier.
Outil

get_altseason_index

L'indice d'altseason - les altcoins surperforment-ils Bitcoin - avec un historique quotidien optionnel.

Paramètre Type Description
days integer Jours d'historique quotidien à inclure (0–365 ; 0 renvoie seulement la lecture actuelle).
Outil

get_liquidations_summary

Les totaux de liquidations de futures du jour avec la répartition long/short et la dominance. Les données peuvent être null juste après la bascule quotidienne.

Cet outil ne prend aucun paramètre.

Exchanges

Outil

list_exchanges

Exchanges classés avec volume 24 h, dominance de volume et décomptes de paires/actifs. Résout aussi les noms d'exchanges en slugs.

Paramètre Type Description
type enum Restreint aux exchanges centralisés (cex) ou décentralisés (dex).
search string Recherche en texte libre, comparée aux noms des exchanges.
sort string Champs de tri séparés par des virgules, préfixe "-" pour décroissant : volume, rank, volume_dominance, change_24h, change_7d, pairs, assets.
limit integer Nombre maximal d'exchanges à renvoyer (1–50, 10 par défaut).
Outil

get_exchange

Profil complet d'un exchange : rang, volume et variations, dominance, paires et actifs listés, et liens.

Paramètre Type Description
slug requis string Slug canonique de l'exchange, p. ex. binance-exchange.
Outil

get_exchange_trust_score

Le score de confiance d'un exchange (0–10) avec sa décomposition complète en 13 facteurs.

Paramètre Type Description
slug requis string Slug canonique de l'exchange.
Outil

get_coin_markets

Où un coin s'échange : ses marchés à travers les exchanges avec paire, prix et volume 24 h, triés par volume.

Paramètre Type Description
slug requis string Slug canonique du coin.
exchange string Slug d'exchange optionnel pour restreindre les résultats à une seule place.
instrument enum Restreint à un type d'instrument : spot, future, option, swap ou margin.
limit integer Nombre maximal de marchés à renvoyer (1–50, 10 par défaut).

Analyse & utilitaires

Outil

get_coin_technicals

L'instantané technique multi-indicateurs d'un coin en un appel : RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilité et plus, chacun avec son dernier état et son score.

Paramètre Type Description
slug requis string Slug canonique du coin.
Outil

convert_currency

Convertit un montant entre n'importe quelles devises crypto et/ou fiat (jusqu'à 10 cibles par appel) avec des taux en direct, en pleine précision décimale.

Paramètre Type Description
from requis string Slug de la devise source, p. ex. bitcoin ou united-states-dollar.
to requis string Slugs des devises cibles séparés par des virgules, jusqu'à 10.
amount number Montant de la devise source à convertir (1 par défaut).
Outil

calculate_dca

Backteste une stratégie d'achats périodiques (DCA) contre l'historique de prix réel : total investi, coins accumulés, valeur actuelle et profits/pertes.

Paramètre Type Description
slug requis string Slug canonique du coin.
amount requis number Montant en USD acheté à chaque intervalle.
interval requis enum Cadence d'achat : daily, weekly, monthly, quarterly ou yearly.
start requis date Date du premier achat au format YYYY-MM-DD (avant aujourd'hui).
end date Date du dernier achat au format YYYY-MM-DD ; aujourd'hui par défaut.
series boolean Inclure la série achat par achat (sortie volumineuse - laissez false sauf demande explicite).