Serveur MCP

get_system_info

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

get_market_data

L’instantané à 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é, marché entier. Sans borne temporelle, il rend le dernier point ; avec since_ms ou until_ms, il bascule sur 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 un 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-instance, identifiant nu pour les six autres, et plafond results + amorçage ≤ 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-timeframe et fenêtrables.

Deux métriques par série — paramètre series

macromacro_intraday

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

Dix-neuf métriques marché entier — aucune 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 photos d’état : elles s’obtiennent par get_market_data, pas par get_history.

Sept métriques sans fenêtre temporelle

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 nettoie sa propre surface, sans rien changer aux valeurs : les clés multi-timeframe 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 CVD prennent le nom qu’ils ont dans les bougies.