a2a-x402-mcp-services

Herramientas MCP monetizadas de x402 v2 orientadas a la producción para el comercio real agente a agente (A2A).

• Liquidación auténtica en cadena (sin mocks, sin pagos simulados)

• Totalmente compatible con la especificación actual de x402 v2 (redes CAIP-2, cabeceras PAYMENT-REQUIRED / PAYMENT-SIGNATURE / PAYMENT-RESPONSE, x402Version: 2, esquema exacto)

• Paquetes oficiales @x402/mcp + @x402/core + @x402/evm

• Listo para Bazaar (las herramientas se descubren a través de facilitadores que implementan la extensión Bazaar)

• Construido frente a las carencias reales del ecosistema: utilidades operativas que los agentes realmente compran de forma recurrente

Herramientas de Pago Actuales

Todas las herramientas usan el esquema de pago exacto y liquidan a través de un facilitador real.

Related MCP server: Agent Commerce Suite

Lista de Verificación de Cumplimiento con x402 v2

• x402Version: 2

• Identificadores de red CAIP-2 (eip155:84532 Base Sepolia por defecto, eip155:8453 para mainnet)

• Cabeceras oficiales (PAYMENT-REQUIRED, PAYMENT-SIGNATURE, PAYMENT-RESPONSE)

• Esquema exacto mediante @x402/evm/exact

• Verificación y liquidación mediante facilitador (nunca autoliquidado en el proceso)

• Metadatos de la extensión Bazaar para el descubrimiento de herramientas MCP

• Dirección payTo determinada por entorno (sin carteras de producción codificadas)

Inicio Rápido (Testnet)

git clone https://github.com/Disseveru/a2a-x402-mcp-services.git
cd a2a-x402-mcp-services
npm install

# Required: receiving wallet (Base Sepolia)
export X402_PAY_TO_EVM=0xYourTestnetAddress

# Optional overrides
# export X402_NETWORK=eip155:84532
# export X402_FACILITATOR_URL=https://x402.org/facilitator
# export PORT=4022

npm run dev

Comprobación de estado (gratuita):

curl http://localhost:4022/health

Catálogo de herramientas (gratuito):

curl http://localhost:4022/tools

Endpoint MCP (de pago):

POST http://localhost:4022/mcp

Usa cualquier cliente MCP compatible con x402 v2 (asistentes de cliente @x402/mcp, carteras gestionadas por CDP, etc.). La primera llamada a una herramienta de pago recibirá un 402 apropiado; el cliente firma y reintenta con PAYMENT-SIGNATURE; el facilitador liquida; se devuelve el resultado de la herramienta.

Pasar a mainnet

1. Establece una dirección de recepción en mainnet:

   export X402_PAY_TO_EVM=0xYourMainnetAddress

2. Cambia de red:

   export X402_NETWORK=eip155:8453

3. Usa un facilitador de producción (ejemplo – CDP):

   export X402_FACILITATOR_URL=https://api.cdp.coinbase.com/platform/v2/x402

   (Proporciona las credenciales CDP si el facilitador elegido las requiere.)

4. Inicia el servidor. Se moverá USDC real.

Nunca ejecutes mainnet con una clave en caliente que tenga más de lo que estés dispuesto a perder.

Arquitectura

src/
  config.ts          – env-driven CAIP-2 + facilitator + payTo
  server.ts          – McpServer + official createPaymentWrapper (@x402/mcp)
  tools/
    definitions.ts   – paid tool implementations (real logic)
  index.ts           – Express host + Streamable HTTP MCP transport

Principios de Diseño

1. Sin mocks – cada camino de pago termina en una llamada real de liquidación al facilitador.

2. Solo v2 – no hay cabeceras heredadas X-PAYMENT ni cadenas de red v1.

3. Utilidad operativa – las herramientas resuelven problemas del agente que generan recompra (riesgo, normalización, selección de facilitador).

4. Descubribles – los metadatos de Bazaar están presentes para que los agentes encuentren las herramientas sin URLs codificadas.

5. Seguridad del operador – la dirección de recepción y la red provienen exclusivamente de variables de entorno.

Licencia

MIT