Servidor MCP

get_system_info

El diagnóstico. En una llamada devuelve la salud del servicio, la lista de símbolos y la frescura de cada fuente. Es la llamada que hay que hacer primero: saber que una fuente va con retraso cambia la confianza que merecen los análisis siguientes.

get_market_data

El snapshot a la carta, apoyado en el snapshot REST. El agente nombra los campos que necesita, el servidor consulta en paralelo y lo ensambla.

get_history

El historial de una métrica, en una ventana fechada, paginado. Se enrutan cuarenta y seis métricas; cada una declara su objetivo, y la validación ocurre antes de cualquier llamada de red.

get_market_emotions

El índice de miedo y codicia, de todo el mercado. Sin límite temporal devuelve el último punto; con since_ms o until_ms pasa al historial. No se acepta ningún símbolo: el índice es global.

get_market_indicators

Los veinte indicadores técnicos, calculados bajo demanda. symbol, timeframe e indicators son obligatorios; solo results tiene valor por defecto, 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},
    ],
})

Se aplican las mismas reglas que en REST: identificadores _fast / _mid / _slow para los catorce tipos multiinstancia, un identificador simple para los otros seis y un límite de results + warm-up ≤ 1000.

Diecinueve métricas por par (parámetro symbol)

basisbuysell_ratiocvd_seriesfunding_cumulativefunding_rate_8hheatmap_clustersliq_cumulativeliq_ratiols_ratioob_aggregatedoi_deltaspreadtokenomicstradetrade_futuretrade_sizetrade_spotvwapvwap_window

Seis métricas por activo (parámetro asset)

options_oioptions_oi_deltaoptions_ivoptions_iv_klinesoptions_pc_ratiooptions_volume

Todas multitemporalidad y con ventana.

Dos métricas por serie (parámetro series)

macromacro_intraday

macro no es multitemporalidad a propósito: cortar una serie mensual en pasos horarios produciría una regresión silenciosa. macro_intraday sí lo es, pero rechaza 30m. Las dos no llevan los mismos instrumentos: no sustituyas una por la otra.

Diecinueve métricas de todo el mercado (sin objetivo)

btc_feesbtc_mempoolbtc_miningbtc_networketh_defieth_deflationeth_gaseth_gas_momentumeth_ratioeth_squeezeeth_stakingeth_supplyfear_greedglobal_marketnet_liquidityonchain_active_addressesonchain_miner_stressonchain_mvrvonchain_nvt

Sin historial propio

price_change, macro_correlations, macro_momentum y macro_risk son instantáneas de estado: se obtienen con get_market_data, no con get_history.

Siete métricas sin ventana de tiempo

funding_rate_8h, funding_cumulative, ls_ratio, spread, trade, trade_spot y trade_future no aceptan since_ms ni until_ms. Pasarlos se rechaza en lugar de ignorarse: un agente creería filtrar una ventana cuando recibe los últimos puntos en bruto. Usa limit solo.

Normalización

El servidor ordena su propia superficie sin cambiar ningún valor: las claves multitemporalidad llevan el nombre del parámetro en lugar del de la API (cvd_series@1h, spread@1h, ob_aggregated@4h), las marcas de tiempo se uniforman como YYYY-MM-DDTHH:MM:SSZ y los volúmenes taker de las filas de CVD toman el nombre que tienen en las velas.