Spraay x402 MCP Server

Puerta de enlace de pagos x402 multicadena y servidor MCP de automatización DeFi. 161 herramientas en 39 categorías: pagos por lotes, intercambios de tokens, puentes, depósitos en garantía, inferencia de IA, staking, gobernanza, oráculos, geoespacial, cómputo GPU, investigación y más. Compatible con Base, Ethereum y Solana, con más de 10 cadenas adicionales. Integrado en las herramientas de AWS Strands Agents y en Google ADK Community Toolkit.

GitHub
4
Prueba este MCPPatrocinado

Documentación

💧 Spraay x402 MCP Server

smithery badge Version Tools License: MIT

Infraestructura DeFi full-stack para agentes de IA: 183 herramientas de pago por llamada, respaldadas por el Gateway Spraay x402 de 192 endpoints en Base, con soporte de pagos en Solana, Ethereum, XRP y Stellar.

Conecta Claude, Cursor o cualquier cliente MCP a pagos onchain, pagos por lotes, swaps, puentes, nómina, facturación, custodia, datos de oráculos, analítica, más de 200 modelos de IA, GPU/computación, APIs de investigación, búsqueda/RAG y más. Los agentes pagan USDC por solicitud mediante el protocolo x402 — sin claves API, sin cuentas.

La lista de herramientas se genera a partir del manifiesto en vivo del gateway en tiempo de compilación (npm run sync), por lo que el catálogo autoritativo y los precios siempre residen en el gateway — consulta Catálogo de herramientas. 24 de los endpoints del gateway son gratuitos (sin pago requerido).

Inicio rápido

Instala y listo — sin configuración, sin claves API, sin variables de entorno. En la primera ejecución, el servidor crea automáticamente una billetera, la guarda en ~/.spraay/.session e imprime la dirección en stderr. Financia esa dirección con USDC en Base y comienza a llamar herramientas.

Lee Seguridad y seguridad de la billetera — estas herramientas mueven fondos reales.

Instalación en una línea (Claude Code)

claude mcp add spraay -s user -- npx -y spraay-x402-mcp

Configuración manual (Cursor / Claude Desktop)

Cursor (.cursor/mcp.json) o Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "spraay": {
      "command": "npx",
      "args": ["-y", "spraay-x402-mcp"]
    }
  }
}

Eso es todo. La primera ejecución imprime algo como:

💧 Spraay created a new wallet: 0xABC…123
   Private key saved to ~/.spraay/.session (keep it safe — it controls funds).
   Fund this address with USDC on Base to start paying for tool calls.

Opcional — usa tu propia billetera

Para firmar con una clave que ya controlas en lugar de la creada automáticamente, establece EVM_PRIVATE_KEY en tu entorno (anula la billetera de sesión). Nunca pegues una clave privada en un archivo de configuración versionado — usa una billetera caliente dedicada financiada solo con lo que el agente pueda gastar. Consulta Seguridad y seguridad de la billetera.

URL remota (sin billetera en tu máquina)

La liquidación se maneja del lado del gateway; tu cliente nunca tiene una clave de firma.

{
  "mcpServers": {
    "spraay": {
      "url": "https://spraay-x402-mcp--plagtech.run.tools"
    }
  }
}

Smithery

smithery mcp add Plagtech/Spraay-x402-mcp

Desde el código fuente

git clone https://github.com/plagtech/spraay-x402-mcp
cd spraay-x402-mcp
npm install
npm run build
npm start                     # auto-creates a wallet on first run

Catálogo de herramientas

183 herramientas que abarcan las 33 categorías del gateway. Destacados por área:

ÁreaQué cubre
IA e InferenciaMás de 200 LLMs (compatibles con OpenAI), clasificación de billeteras/tx, explicación de contratos, resúmenes
ComputaciónTexto / imagen / video / TTS / STT / embeddings en Replicate, Chutes, OpenRouter; trabajos por lotes
Futuros de computaciónCréditos de computación prepagados con descuentos por nivel; consumo por inferencia
BittensorInferencia descentralizada, generación de imágenes y embeddings vía SN64 / SN19
PagosPagos por lotes de hasta 200 destinatarios (Base, XRP Ledger, Stellar); estimaciones
NóminaEjecuciones de nómina en stablecoins en Base, Ethereum, Solana
Facturación y custodiaFacturas nativas cripto y custodia por hitos (persistentes)
DeFi y datosSwaps (Uniswap V3 / Aerodrome), precios de oráculos/gas/FX, cotizaciones de puentes, saldos, ENS/Basename
AnalíticaPerfiles de billeteras e historial de transacciones decodificado
InvestigaciónMás de 250M de artículos (OpenAlex), arXiv, Crossref, PubMed, PubChem, censo de EE. UU., diccionario
Búsqueda y RAGBúsqueda web, extracción de contenido, respuesta a preguntas
ComunicaciónCorreo electrónico, SMS, mensajería XMTP, webhooks
InfraestructuraRPC multicadena, almacenamiento IPFS/Arweave, programación cron, registros estructurados
Identidad y cumplimientoVerificación KYC/sanciones, sesiones de autenticación, rastro de auditoría, impuestos cripto (FIFO, IRS 8949)
Cadena de suministro (SCTP)Registro de proveedores, órdenes de compra, verificación de facturas, liquidación
Robótica (RTP)Registrar robots, despachar tareas pagadas, finalización respaldada por custodia
Confianza y seguridadPuntajes de confianza ProofLayer; verificaciones gratuitas de seguridad de tokens, direcciones y decodificación de tx

24 endpoints gratuitos no requieren pago — gas/precios/estado de la cadena, validación de direcciones y lotes, resolución ENS, conversión de unidades, sondeos de descubrimiento x402 y descubrimiento de modelos/computación.

Para la lista exacta y actual de herramientas y precios por herramienta, consulta el manifiesto en vivo:

curl https://gateway.spraay.app/.well-known/x402.json

Los precios van desde $0.001 (lecturas) hasta ~$0.10 (nómina, liberación de custodia, impuestos), liquidados en USDC en Base.

Cómo funciona

  1. Un agente llama a una herramienta (p. ej., spraay_batch_execute).
  2. El servidor MCP accede al Gateway Spraay x402.
  3. El gateway responde 402 Payment Required con un monto en USDC.
  4. Modo remoto: la liquidación se maneja del lado del gateway. Modo local: @x402/axios firma un micropago en USDC desde la billetera creada automáticamente (o anulada).
  5. El gateway valida el pago y devuelve los datos.

Seguridad y seguridad de la billetera

Estas herramientas pueden iniciar pagos reales en USDC. Trata el servidor como cualquier herramienta con acceso a fondos.

  • La billetera creada automáticamente solo contiene lo que le envíes. Finánciala solo con el USDC que estés dispuesto a que el agente gaste. Comienza vacía, por lo que una instalación nueva no puede mover fondos hasta que la financien; las herramientas de solo lectura funcionan de todos modos.
  • La clave de sesión reside en ~/.spraay/.session. Protege ese archivo como cualquier secreto: cualquiera que lo lea controla la billetera. Se escribe con permisos 0600 en sistemas POSIX. Haz una copia de seguridad si los fondos importan; elimínalo para rotar a una nueva billetera en la próxima ejecución.
  • Prefiere la URL remota si prefieres no tener una clave de firma en tu máquina — la liquidación se maneja del lado del gateway.
  • Si usas tu propia clave vía EVM_PRIVATE_KEY, usa una billetera caliente dedicada que no controle otros activos, y nunca pongas una clave privada en un archivo de configuración, issue o cualquier archivo versionado — mantenla solo en tu entorno de shell.

El paquete npm publicado incluye solo dist/, README y LICENSE (verifica con npm pack --dry-run) — sin binarios, sin herramientas de compilación, sin scripts de instalación.

Reporta problemas de seguridad a security@spraay.app, no en un issue público.

Requisitos

  • Node.js 20+
  • Cliente MCP — Claude Desktop, Cursor o cualquier cliente compatible con MCP
  • USDC en Base — financia la billetera creada automáticamente (o la tuya); incluso $1 cubre miles de llamadas

Variables de entorno

No se requiere ninguna: el servidor funciona con configuración cero. Todas las siguientes son anulaciones opcionales.

VariableRequeridaPredeterminadoDescripción
EVM_PRIVATE_KEYNocreada automáticamente en ~/.spraay/.sessionAnula la billetera creada automáticamente con tu propia clave. Usa una billetera caliente dedicada y financiada según sea necesario.
SPRAAY_GATEWAY_URLNohttps://gateway.spraay.appAnula la URL del gateway.

Enlaces

Licencia

MIT