Xenarch — Servidor MCP x402 para pagos de agentes de IA

Xenarch es un servidor MCP x402 no custodial que permite a los agentes de IA pagar por APIs y contenidos protegidos por HTTP 402 con micropagos en USDC en Base L2. Los agentes de Claude, Cursor, LangChain y CrewAI resuelven automáticamente las respuestas HTTP 402 ("Payment Required"): sin claves de API, sin suscripciones, sin tarjetas de crédito registradas. Los pagos se liquidan en la cadena directamente en la billetera del editor a través de cualquier facilitador x402. Es agnóstico al facilitador, con 0% de comisión y sin contratos intermediarios.

Qué hace diferente a Xenarch

Related MCP server: pay-mcp

Cómo funciona

1. Discover    xenarch_check_gate("example.com")
               → { gated: true, accepts: [...], facilitators: [...] }

2. Pay         xenarch_pay("example.com")
               → x402-fetch signs an EIP-3009 USDC transferWithAuthorization
               → Submits via the chosen facilitator on Base
               → Re-fetches the resource with proof of payment
               → { tx_hash, facilitator, content }

Sin claves de API. Sin registro. El agente paga directamente en la cadena: Xenarch nunca retiene fondos y no hay contratos intermediarios entre el agente y el editor.

Herramientas MCP

Tres herramientas para agentes de IA:

Respuestas de ejemplo

{
  "gated": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "maxAmountRequired": "3000",
      "resource": "https://example.com/article",
      "payTo": "0xabc123...publisher_wallet",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "maxTimeoutSeconds": 60
    }
  ],
  "facilitators": [
    { "name": "PayAI", "url": "https://facilitator.payai.network", "priority": 1, "spec_version": "v1" },
    { "name": "xpay", "url": "https://facilitator.xpay.dev", "priority": 2, "spec_version": "v2" }
  ],
  "seller_wallet": "0xabc123...publisher_wallet",
  "network": "base",
  "asset": "USDC"
}

{
  "success": true,
  "gate_id": "7f3a1b2c-9d4e-4a8b-b6f1-2c3d4e5f6a7b",
  "tx_hash": "0xdef456...abc789",
  "facilitator": "PayAI",
  "seller_wallet": "0xabc123...publisher_wallet",
  "url": "https://example.com/article",
  "wallet": "0x123...your_wallet",
  "content": "...gated content here..."
}

{
  "payments": [
    {
      "domain": "example.com",
      "amount_usd": "0.003",
      "tx_hash": "0xdef456...abc789",
      "paid_at": "2026-04-10T14:35:00Z"
    }
  ],
  "total_spent_usd": "0.003000",
  "count": 1,
  "wallet": "0x123...your_wallet"
}

HTTP 402 — el código de estado no utilizado que x402 finalmente activa

HTTP 402 Payment Required es un código de estado reservado en la especificación HTTP desde 1997 para pagos entre máquinas. Permaneció sin uso durante décadas porque no existía un protocolo abierto sobre cómo un cliente debía pagar una respuesta 402.

x402 es ese protocolo: un servidor devuelve HTTP 402 con un precio firmado y detalles de pago, el cliente firma un micropago en USDC en Base L2 y reintenta la solicitud con la prueba de pago. El servidor MCP de Xenarch automatiza ambas partes para los agentes de IA: lee el desafío 402, firma el pago a través de x402-fetch y vuelve a realizar la solicitud, devolviendo el hash de la transacción en la cadena más el contenido protegido.

Más información: la especificación x402 define el protocolo de pago; pay.json (creado por Xenarch) es el estándar abierto complementario para precios legibles por máquina servidos en /.well-known/pay.json: piensa en él como un robots.txt para pagos.

Monetización de API con HTTP 402

Xenarch es una primitiva de monetización de API construida sobre la especificación HTTP 402. A diferencia de las plataformas de monetización de puertas de enlace de API (Apigee, Kong, AWS API Gateway) que requieren suscripciones, paneles y claves de API, Xenarch permite que cualquier API cobre por solicitud sin creación de cuenta ni aprovisionamiento de claves: el emisor paga USDC en Base L2, la API verifica la transacción en la cadena y se concede el acceso.

Para los editores, esto significa:

• Sin integración con Stripe/procesadores de tarjetas

• Sin planes de suscripción, niveles de precios o paneles de cuotas

• Sin saldo custodial retenido por una plataforma

• Precios por solicitud que funcionan uniformemente para usuarios humanos, bots y agentes de IA

• Monetización de API que se liquida en la cadena en tiempo real

El SDK de Python incluye un middleware de FastAPI de un solo decorador; consulta xenarch-sdks/python para la integración del editor.

Configuración

1. Configura tu billetera:

mkdir -p ~/.xenarch
cat > ~/.xenarch/wallet.json << 'EOF'
{
  "privateKey": "0xYOUR_PRIVATE_KEY"
}
EOF
chmod 600 ~/.xenarch/wallet.json

2. Añade a Claude Code:

claude mcp add xenarch -- npx @xenarch/agent-mcp

O añade a Claude Desktop / Cursor / cualquier cliente MCP:

{
  "mcpServers": {
    "xenarch": {
      "command": "npx",
      "args": ["@xenarch/agent-mcp"],
      "env": {
        "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Variables de entorno

Ejemplos

Consulta xenarch-examples para ver ejemplos de integración funcionales: agentes de Python, LangChain, CrewAI, configuración de Claude Desktop y middleware para editores.

Desarrollo

npm install
npm run build

Estructura

packages/
  shared/    — Payment logic, types, config (reused across servers)
  agent/     — MCP server for AI agents

Preguntas frecuentes

¿Cómo paga Claude por las APIs con Xenarch? Instala el servidor MCP de Xenarch (claude mcp add xenarch -- npx @xenarch/agent-mcp), asígnale una billetera y Claude resolverá automáticamente cualquier respuesta HTTP 402 con un micropago en USDC en Base L2.

¿Funciona Xenarch con Cursor, LangChain o CrewAI? Sí. Xenarch expone un servidor MCP que cualquier cliente compatible con MCP puede usar: Claude Code, Claude Desktop, Cursor, Cline, LangChain, CrewAI y cualquier otro cliente que utilice el Protocolo de Contexto de Modelo (Model Context Protocol).

¿Es compatible FastAPI para editores? Sí, a través del SDK de Python (pip install xenarch[fastapi): un middleware de un solo decorador devuelve HTTP 402 con el precio y verifica el pago en la cadena. Consulta xenarch-sdks/python.

¿Es Xenarch custodial? No. Los pagos se liquidan en la cadena como una transferencia directa de USDC desde la billetera del agente a la billetera del editor. Los fondos nunca tocan la infraestructura de Xenarch y no hay contratos intermediarios.

¿Cuál es la comisión? 0%, estructuralmente. Xenarch nunca interviene en el flujo de dinero: el agente paga al editor directamente en la cadena a través de cualquier facilitador x402.

¿Cuál es el pago máximo por llamada? $1 USD.

¿Qué es x402? x402 es un protocolo abierto para HTTP 402 Payment Required. Un servidor devuelve 402 con un precio, el cliente firma un micropago en USDC en Base L2 (u otra cadena compatible) y reintenta la solicitud con la prueba de pago.

¿Qué es HTTP 402? HTTP 402 Payment Required es un código de estado reservado en la especificación HTTP desde 1997 para pagos entre máquinas. x402 es el protocolo abierto que finalmente lo utiliza.

¿Cómo se compara Xenarch con Cloudflare Pay-Per-Crawl? Cloudflare Pay-Per-Crawl solo funciona para sitios detrás de Cloudflare y es custodial. Xenarch funciona en cualquier host y no es custodial: a los editores se les paga directamente en la cadena.

¿Cómo se compara Xenarch con TollBit? TollBit se centra en licencias empresariales. Xenarch es de autoservicio, no custodial y funciona para la larga cola de editores y cualquier agente de IA sin contratos empresariales.

Enlaces

• Sitio web: https://xenarch.com

• npm: https://www.npmjs.com/package/@xenarch/agent-mcp

• PyPI: https://pypi.org/project/xenarch/

• Smithery: https://smithery.ai/servers/xenarch/xenarch-mcp

• GitHub: https://github.com/xenarch-ai/xenarch-mcp

Licencia

MIT