x402: el piloto de pago por llamada

El alcance exacto, sin adornos

Definición del piloto en code/mcp-server/src/x402.ts.

Parámetro	Valor	Por qué importa
Herramienta pagada	get_service_info_paid (una sola)	El resto del servidor sigue gratis; no hay catálogo de pago
Red	eip155:84532 (Base Sepolia)	Es una testnet: no hay dinero real en juego
Esquema	exact	Un importe exacto por llamada, sin subastas ni presupuestos
Precio	0,01 USDC	Fijo en el código; no lo negocia el cliente
Facilitador	https://x402.org/facilitador público de testnet	Verifica el pago; si falla, la llamada no se ejecuta
Efecto en la cuota	Ninguno (X402_MCP_PAID_TOOL = 0 unidades)	El pago es on-chain; la fila en AI Tasker es solo auditoría

El piloto está detrás de un flag: con X402_ENABLED sin definir o en false, la configuración del piloto devuelve null y la herramienta ni siquiera se registra. Eso significa que la respuesta a "¿puedo pagar por llamada?" depende del despliegue concreto, y se comprueba, no se supone.

Cómo se comporta una llamada

El diseño es fail-closed, y esa es su propiedad más importante: el handler de la herramienta no se ejecuta si el pago no está verificado. No hay ventana en la que el servidor haga el trabajo y cobre después.

1. El cliente pide get_service_info_paid como cualquier otra herramienta.
2. Si no hay pago válido, la llamada no produce resultado: el wrapper de x402 exige requisitos de pago verificados antes de entrar al handler.
3. El pago se liquida en la red con el esquema exact, con el facilitador de testnet verificando.
4. Tras el settlement, el servidor MCP registra la operación en el backend con POST /api/x402/settlements, autenticado con la API key atkr_ del agente.
5. La fila creada es X402_MCP_PAID_TOOL con units: 0: aparece en la auditoría y no consume cuota del workspace.

Si el facilitador tarda o devuelve un error, la verificación no pasa y no hay ejecución ni registro. Es preferible un fallo visible a un cargo fantasma: el piloto está diseñado para no dejar pagos sin rastro ni trabajo sin pago.

Cómo comprobar si está activo

Tres comprobaciones, de la más barata a la más concluyente:

• El catálogo público de la web (40 herramientas) no incluye get_service_info_paid: se genera del código y solo lista lo que está siempre registrado. Si aparece ahí, algo cambió y hay que revisarlo.
• tools/list del servidor desplegado es la fuente de verdad: si la herramienta está, el piloto está activo en ese despliegue; si no está, está apagado.
• El precio y la red se leen del propio anuncio de la herramienta en tools/list, no de esta página: si el piloto cambia, cambia ahí.

Búsqueda de la herramienta pagada en el catálogo desplegado (necesita una API key válida y sesión MCP).

curl -s -X POST https://mcp.ai-tasker.theboomer.dev/mcp \
  -H "Authorization: Bearer atkr_tu_clave" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SID" \
  -d '{"jsonrpc":"2.0","id":9,"method":"tools/list","params":{}}' \
  | jq -r '.result.tools[].name' | grep -i paid || echo "piloto x402 no expuesto"

Por qué no es el modelo de cobro

Tres razones concretas, y conviene tenerlas a mano cuando alguien pregunte:

• Cubre una herramienta, no el producto. Las otras 40 siguen disponibles con la cuota normal del workspace.
• Corre en testnet. Base Sepolia es una red de pruebas: sirve para validar el flujo, no para ingresar.
• No mueve la cuota. Una llamada x402 no gasta créditos ni descuenta del cupo mensual: si se contase como operación, el piloto estaría cobrando dos veces.

El modelo real sigue siendo el de siempre: asientos de 2,00 € al mes por unidad facturable más créditos prepagados para el consumo. Quien quiera entender ese modelo tiene el monedero y el presupuesto por agente en sus propias guías.

Lo que el diseño protege

Riesgo	Cómo se corta
Claves privadas en el servidor	No hay ninguna: solo la dirección payTo pública. El proceso no firma pagos
Datos sensibles en logs	No se registran payloads de pago ni firmas; solo identificadores verificables
Doble cobro por reintento	Operation.idempotencyKey (SHA-256 del pago) con índice único: un replay devuelve la fila existente
Cargo sin trabajo o trabajo sin cargo	Fail-closed: sin verificación no hay handler; el registro se hace solo tras settlement
Proceso que muere a medias	La operación queda pending y la reconciliación la revierte: nunca un cargo fantasma
Replay de un pago revertido	Conflicto 409, nunca un éxito silencioso

El endpoint de registro es estrecho a propósito: POST /api/x402/settlements exige identidad de API key (403 X402_API_KEY_REQUIRED sin ella), valida la red (X402_UNSUPPORTED_NETWORK), la herramienta (X402_UNSUPPORTED_TOOL) y el esquema, y no acepta campos libres. No es una API de pagos: es el libro de auditoría del piloto.

Si quieres construir sobre x402

1. Comprueba con tools/list si la herramienta pagada está expuesta en el despliegue que vas a usar.
2. Trata el pago como una condición previa, no como un resultado: si no hay settlement, no hay datos.
3. Registra el paymentId que devuelve el flujo para poder casar el pago con la auditoría del servidor.
4. No uses el piloto como argumento comercial de "pago por uso": el pago por uso real son los créditos.

Comprobar y usar el piloto x402 de AI Tasker

Verificar si la herramienta pagada está expuesta, entender el flujo fail-closed y no confundir el piloto con el modelo de cobro.

1. Abre sesión MCP

   initialize y mcp-session-id como en cualquier cliente MCP; hace falta una API key atkr_ válida.

2. Lista las herramientas

   tools/list y busca get_service_info_paid. Si no aparece, el piloto está apagado en ese despliegue.

3. Lee el anuncio de pago

   El precio (0,01 USDC), la red (eip155:84532) y el esquema (exact) salen del propio anuncio de la herramienta.

4. Llama solo con pago verificado

   Sin settlement no hay ejecución: el wrapper exige el pago antes de entrar al handler.

5. Verifica el registro

   Tras el settlement queda una fila X402_MCP_PAID_TOOL con 0 unidades, visible como auditoría y sin consumir cuota.

Preguntas frecuentes

¿Puedo pagar cualquier llamada con x402?

No. El piloto cubre una sola herramienta, get_service_info_paid, en Base Sepolia y a 0,01 USDC. El resto de operaciones se pagan con la cuota del workspace y sus créditos.

¿x402 consume créditos?

No. La operación se registra como X402_MCP_PAID_TOOL con 0 unidades: es auditoría. El pago ocurre on-chain y no toca el cupo mensual ni el monedero.

¿Cómo sé si está activo en mi despliegue?

Con tools/list: si get_service_info_paid aparece, el piloto está expuesto; si no, está apagado. El catálogo público de 40 herramientas no lo incluye porque solo lista lo que está siempre registrado.

¿Qué pasa si el facilitador falla?

La verificación no pasa, el handler no se ejecuta y no se registra nada. El diseño es fail-closed: antes un fallo visible que un cargo sin trabajo.

¿Se puede cobrar dos veces el mismo pago?

No. El identificador del pago se hashea y tiene índice único: un replay devuelve la fila existente, y si la entrada fue revertida responde 409.

¿Es dinero real?

No. La red del piloto es Base Sepolia, una testnet pública. Sirve para validar el flujo, no para facturar.

Fuentes

• Catálogo público de herramientas (40, sin la pagada)
  https://ai-tasker.theboomer.dev/llms-full.txt
• Planes, operaciones y su coste
  https://api.ai-tasker.theboomer.dev/api/plans
• Contrato OpenAPI de la API
  https://api.ai-tasker.theboomer.dev/api/openapi.json

Cifras verificadas contra la API en vivo y las páginas oficiales de cada producto el 21 de octubre de 2026. Los precios de terceros pueden cambiar: contrasta con la página oficial antes de publicar.

Guías relacionadas

• Todas las guías — Cómo elegir gestor de tareas, MCP y ciclo de vida para agentes de IA.
• Monedero de créditos: recarga y control de gasto — Cómo funciona el monedero de AI Tasker: qué operación consume cada crédito, cómo recargar con packs o AutoRefill, y qué pasa cuando el saldo llega a cero.
• Presupuesto y cuotas por agente — Cómo repartir créditos y cuotas entre varios workspaces y agentes en AI Tasker: qué devuelve cada muro, cómo leer el consumo y cómo cortar el gasto.
• Usar la API de AI Tasker sin SDK — La API HTTP de AI Tasker sin librería: autenticación con x-api-key, creación de tareas idempotente, paginación por cursor y qué hacer con cada error.
• Cómo se cobra el uso de agentes — Cómo AI Tasker mide y cobra el uso de agentes: unidad facturable de 2 €, operaciones, packs y recarga automática. Sin sorpresas.
• Precios — Precios reales: plan gratuito y unidad facturable de 2,00 €/mes.
• Integración MCP — https://mcp.ai-tasker.theboomer.dev/mcp
• /llms.txt — Contrato legible por máquina.