@fsantag/x402-mcp — servicios x402 de agentsats como tools MCP

Servidor MCP (Model Context Protocol) que expone los servicios x402 publicados en xl402.agentsats.org como tools para cualquier cliente MCP (Claude Desktop, IDEs, agentes). Cuando el agente invoca una tool, este server paga con x402 (USDC en Base) y devuelve el resultado. Es la pieza de distribución/demanda (P2): hace los servicios descubribles e invocables desde el tooling de agentes, sin que el dev tenga que implementar el flujo x402.

Tools

| Tool | Servicio | Precio | Entrada | |---|---|---|---| | agentic_report | /v1/agentic-report | $0.50 USDC (Base) | topic, audience (technical|executive|general), format, max_words, language | | web_extract | /v1/web-extract | $0.02 USDC (Base) | url*, format (markdown|html), only_main_content, timeout_ms |

Requisitos

• Node ≥ 20.
• Una wallet con USDC en Base (paga las llamadas). Se pasa por X402_PRIVATE_KEY.

  ⚠️ Usa una wallet dedicada de bajo saldo (es una clave en claro en la config). El gasto es real: cada invocación liquida el precio de la tool on-chain.

Uso

Publicado en npm — no necesitas clonar el repo ni instalar nada:

npx -y @fsantag/x402-mcp

(Para desarrollo desde el código fuente: npm install en mcp/ y luego node server.mjs.)

Configuración (variables de entorno)

| Var | Req. | Def. | Qué es | |---|---|---|---| | X402_PRIVATE_KEY | sí | — | Clave (0x…) de la wallet que paga (USDC en Base) | | X402_SERVER | no | https://xl402.agentsats.org | Base del gateway | | X402_RPC_URL | no | https://mainnet.base.org | RPC de Base |

Claude Desktop

En claude_desktop_config.json (Ajustes → Developer → Edit Config):

{
  "mcpServers": {
    "x402-agentsats": {
      "command": "npx",
      "args": ["-y", "@fsantag/x402-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xTU_CLAVE_DE_WALLET_DEDICADA"
      }
    }
  }
}

Reinicia Claude Desktop; las tools agentic_report y web_extract aparecerán disponibles.

Prueba rápida (sin Claude)

# lista de tools (handshake MCP, no gasta):
npx -y @modelcontextprotocol/inspector npx -y @fsantag/x402-mcp

Notas

• Añadir un servicio = añadir una entrada a TOOLS en server.mjs (mismo input_schema que el descriptor del servicio). Futuro: autodescubrir desde el Bazaar por payTo.
• El server es stateless: no guarda claves ni resultados; la clave vive solo en tu config.
• Código fuente: mcp/server.mjs. Patrón de pago reutilizado de scripts/canary-*.mjs.