Serveur MCP

get_system_info

Le diagnostic. En un appel, il ramène la santé du service, la liste des symboles et la fraîcheur de chaque source. C’est l’appel à faire en premier : savoir qu’une source est en retard change la confiance à accorder aux analyses qui suivent.

get_market_data

Le snapshot à la carte, adossé au snapshot REST. L’agent nomme les champs dont il a besoin, le serveur interroge en parallèle et assemble.

get_history

L’historique d’une métrique, sur une fenêtre datée, paginé. Quarante-six métriques sont routées ; chacune déclare sa cible, et la validation a lieu avant tout appel réseau.

get_market_emotions

L’indice de peur et d’avidité, tout le marché. Sans borne temporelle, il renvoie le dernier point ; avec since_ms ou until_ms, il passe à l’historique. Aucun symbole n’est accepté : l’indice est global.

get_market_indicators

Les vingt indicateurs techniques, calculés à la demande. symbol, timeframe et indicators sont obligatoires ; seul results a une valeur par défaut, à 1.

await c.call_tool("get_market_indicators", {
    "symbol": "BTCUSDT",
    "timeframe": "1h",
    "results": 60,
    "indicators": [
        {"id": "rsi_fast", "type": "rsi", "period": 7},
        {"id": "rsi_slow", "type": "rsi", "period": 21},
        {"id": "macd", "type": "macd", "fast": 12, "slow": 26, "signal": 9},
        {"id": "adx_mid", "type": "adx", "period": 14},
    ],
})

Les mêmes règles s’appliquent qu’en REST : identifiants _fast / _mid / _slow pour les quatorze types multi-instances, un identifiant nu pour les six autres, et un plafond de results + warm-up ≤ 1000.

Dix-neuf métriques par paire (paramètre symbol)

basisbuysell_ratiocvd_seriesfunding_cumulativefunding_rate_8hheatmap_clustersliq_cumulativeliq_ratiols_ratioob_aggregatedoi_deltaspreadtokenomicstradetrade_futuretrade_sizetrade_spotvwapvwap_window

Six métriques par actif (paramètre asset)

options_oioptions_oi_deltaoptions_ivoptions_iv_klinesoptions_pc_ratiooptions_volume

Toutes multi-unités de temps et fenêtrables.

Deux métriques par série (paramètre series)

macromacro_intraday

macro n’est volontairement pas multi-unités de temps : découper une série mensuelle en pas horaires produirait une régression silencieuse. macro_intraday l’est, mais refuse 30m. Les deux ne portent pas les mêmes instruments : ne substituez pas l’une à l’autre.

Dix-neuf métriques de tout le marché (sans cible)

btc_feesbtc_mempoolbtc_miningbtc_networketh_defieth_deflationeth_gaseth_gas_momentumeth_ratioeth_squeezeeth_stakingeth_supplyfear_greedglobal_marketnet_liquidityonchain_active_addressesonchain_miner_stressonchain_mvrvonchain_nvt

Sans historique dédié

price_change, macro_correlations, macro_momentum et macro_risk sont des instantanés d’état : on les obtient par get_market_data, pas par get_history.

Sept métriques sans fenêtre de temps

funding_rate_8h, funding_cumulative, ls_ratio, spread, trade, trade_spot et trade_future n’acceptent pas since_ms ni until_ms. Les passer est refusé plutôt qu’ignoré : un agent croirait filtrer une fenêtre alors qu’il reçoit les derniers points bruts. Utilisez limit seul.

Normalisation

Le serveur range sa propre surface, sans changer aucune valeur : les clés multi-unités de temps portent le nom du paramètre plutôt que celui de l’API (cvd_series@1h, spread@1h, ob_aggregated@4h), les horodatages sont uniformisés en YYYY-MM-DDTHH:MM:SSZ, et les volumes taker des lignes de CVD prennent le nom qu’ils ont dans les bougies.