x402-mcp

Estructura de mercado cripto entre exchanges para agentes de IA. 20 exchanges, 26 tokens, 9 herramientas: flujo de órdenes, CVD, actividad de ballenas, funding/OI, OHLCV de 7 años, riesgo de direcciones on-chain. Gratis vía MCP.

x402-mcp es un servidor MCP stdio que expone x402.tunedfor.ai — una API de estructura de mercado cripto en tiempo real — como 9 herramientas que cualquier cliente compatible con MCP (Claude Desktop, Cursor, Cline, Windsurf, Claude Code) puede llamar. Gratis vía MCP para pruebas y consultas de baja frecuencia; REST de pago en los mismos endpoints para agentes de producción que necesiten mayor rendimiento.

Instalación

Claude Desktop / Cursor / Windsurf

Añadir a la configuración de MCP (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, equivalente en otros SO):

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "@tunedforai/x402-mcp"]
    }
  }
}

Claude Code

claude mcp add x402 -- npx -y @tunedforai/x402-mcp

Cline / Continue / otros clientes MCP

Utilice la misma invocación npx -y @tunedforai/x402-mcp como comando stdio.

Manual

npm install -g @tunedforai/x402-mcp
x402-mcp  # runs the stdio server

Herramientas

Las 9 herramientas son sin estado. Sin clave API, sin autenticación, sin configuración. Solo llámalas.

Cobertura de tokens

• Nivel Snapshot (17 tokens): BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, LINK, ATOM, DOT, ARB, SUI, OP, LTC, AMP, ZEC

• Nivel Flujo de órdenes + historial (26 tokens): todos los anteriores + NEAR, AAVE, BCH, HBAR, SHIB, TON, TRX, UNI, XLM

Ejemplos

Verificación pre-trade

You: marketSnapshot BTC
LLM: BTC at $74,180. Buy ratio 58% — bullish lean. Funding rate +0.012%
     (mild long bias). Open interest $14.2B. Fear & Greed: 32 (Fear).
     Snapshot 12 sec old.

Flujo de órdenes entre exchanges

You: marketOrderflow ETH
LLM: ETH cross-exchange CVD: -$1.2M last hour (sell-side dominant).
     Whale activity: 8 large bars across Binance/Coinbase/Bybit.
     Liquidations: $890K longs, $230K shorts. Pressure: bearish.

Datos de backtest

You: history1d BTC limit=365
LLM: [returns 365 daily bars: open/high/low/close/volume/buy_volume/sell_volume]

MCP gratuito vs REST de pago

El wrapper MCP es gratuito con límites de tasa — perfecto para pruebas, prototipos, flujos de trabajo de agentes de baja frecuencia y uso personal.

Para agentes de producción (polling 24/7, monitoreo multi-token, backtesting a escala), utilice los endpoints REST de pago en x402.tunedfor.ai. REST es:

• Pago por llamada en USDC en Base o Solana vía el protocolo x402

• Sin claves API — su agente firma el pago localmente; la clave privada nunca sale de su máquina

• Sin límites de tasa — pague por lo que usa

• Sin suscripciones — sin mínimos mensuales

Llame a apiInfo desde cualquier cliente MCP para obtener la lista de precios actual, guía de migración y ejemplos de SDK.

Cómo funciona el pago x402 (nivel REST)

Cuando su agente llama a un endpoint REST de pago:

1. La primera solicitud devuelve HTTP 402 Payment Required con el precio

2. El agente firma un pago en USDC localmente (la clave privada nunca sale del agente)

3. El agente reintenta con el encabezado de pago adjunto

4. El servidor verifica la liquidación on-chain y devuelve los datos

Sin cuentas, sin claves API, sin tarjetas de crédito. Solo USDC y una billetera.

Fuentes de datos

• Precio + ticker: APIs públicas de OKX, Coinbase

• Funding / OI / liquidaciones: Coinalyze (licencia comercial)

• Métricas on-chain, flujos de exchange, ratios de ballenas: Santiment (licencia comercial)

• Flujo de órdenes entre exchanges (CVD, barras de ballenas, agregaciones de liq): Agregador WebSocket a través de 20 exchanges hacia InfluxDB, normalizado en barras de 1 minuto

• Contexto macro (DXY, VIX, rendimientos del Tesoro): FRED + Finviz

• Índice de Miedo y Codicia: alternative.me

No redistribuimos ticks brutos de exchanges — servimos agregados derivados y calculados.

Enlaces

• Servicio: x402.tunedfor.ai

• Documentación REST: x402.tunedfor.ai/catalog

• Inicio rápido: x402.tunedfor.ai/llms.txt

• npm: @tunedforai/x402-mcp

• Smithery: smithery.ai/server/@tunedforai/x402-mcp

• Problemas / solicitudes: github.com/tunedforai/x402-mcp/issues

• Protocolo x402: x402.org

Licencia

MIT © Tuned For AI