x402-mcp

Estructura de mercado cripto entre exchanges para agentes de IA. 20 exchanges, 26 tokens, 6 herramientas: snapshot, flujo de órdenes, régimen macro, análisis completo, riesgo de direcciones e información de API. Gratis vía MCP.

👁 npm version
👁 License: MIT

x402-mcp es un servidor MCP stdio que expone x402.tunedfor.ai - una API de estructura de mercado cripto en tiempo real - como 6 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 sistemas operativos):

{
 "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 que el comando stdio.

Manual

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

Related MCP server: AgentPay x402 — Economic-intelligence layer for AI Agents

Herramientas

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

Cobertura de tokens

Principales L1 y L2 en el nivel de snapshot: BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, LINK, ATOM, DOT, ARB, SUI, OP, LTC.

Nivel extendido de flujo de órdenes: los anteriores más NEAR, AAVE, BCH, HBAR, SHIB, TON, TRX, UNI, XLM.

Llame a apiInfo desde cualquier cliente MCP para obtener la lista actual autorizada.

Ejemplos

Verificación previa a la operación

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.

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 (sondeo 24/7, monitoreo de múltiples tokens, backtesting a escala), utilice los endpoints REST de pago en x402.tunedfor.ai. REST es:

• Pago por llamada en USDC en Base o Solana a través del protocolo x402

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

• Límite de tasa de 60 llamadas/minuto y 200 llamadas/hora por billetera — evita la extracción masiva; 429 en caso de incumplimiento

• Sin suscripciones — sin mínimos mensuales

Llame a apiInfo desde cualquier cliente MCP para obtener el calendario de precios actual, la 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: datos institucionales de terceros con licencia

• Flujo de órdenes entre exchanges (CVD, barras de ballenas, agregaciones de liquidación): agregador WebSocket a través de 20 exchanges en 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 datos brutos de los exchanges; servimos agregados derivados y calculados. Todos los campos de origen brutos se transforman en nuestras propias señales compuestas antes de que se devuelvan las respuestas.

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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• addressRiskB
• apiInfoB
• history1dA
• history1hA
• history5mB
• marketAnalyzeC
• marketFullB
• marketOrderflowC