Agent Verification Utility

Verificaciones JSON deterministas con evidencia firmada y ejecución pagada con x402

Ver en kgninja.dev

Documentación

Interoperabilidad MCP y x402

Un flujo de compra machine-first que mantiene el descubrimiento y la cotización gratuitos mientras cobra solo por la ejecución determinista.

Transporte MCP público

El endpoint HTTP Streamable sin estado es https://agent-economy.kgninja.dev/mcp.. Un cliente puede llamar a tools/list sin autenticación. Las herramientas gratuitas son describe_verify_evidence, get_revenue_goal_status, quote_verify_evidence y prepare_verify_evidence_purchase. La herramienta de pago es verify_evidence.

Secuencia de la herramienta de pago

  1. Envía POST { request, spend_policy } a la verificación previa gratuita y copia su resumen de recibo en la intención de pago.
  2. Llama a verify_evidence con una clave de idempotencia única y esa intención completa.
  3. Una llamada no pagada devuelve un error de herramienta MCP cuyo _meta["x402/error"] contiene un documento PaymentRequired de x402 v2 y un enlace de verificación de pago.
  4. Valida el hash de la verificación previa, el resumen del enlace, el límite de precio, la versión de la política, el resumen de evidencia, la expiración de la cotización, el esquema, la red CAIP-2, el activo, el monto y la dirección de recepción según la política local.
  5. Firma un requisito compatible con un cliente compatible con x402 solo cuando todos los campos siguen coincidiendo.
  6. Reintenta la misma llamada de herramienta con el pago codificado en _meta["x402/payment"].
  7. Conserva _meta["x402/payment-response"], el enlace entregado con el ID de recibo de pago y la evidencia firmada.

La ruta HTTP https://agent-economy.kgninja.dev/verify-evidence puede crear su propia cotización vinculada solo a partir de una intención de pago completa y devolver PAYMENT-REQUIRED directamente; las sondas vacías o de solicitud en bruto fallan antes de que se cree una cotización o un requisito de pago. Llamar primero a https://agent-economy.kgninja.dev/quote sigue disponible para la verificación económica previa explícita. Ambos modos usan encabezados PAYMENT-SIGNATURE y PAYMENT-RESPONSE equivalentes y requieren el mismo resumen de enlace.

Superficies de descubrimiento

La extensión Bazaar de x402 está presente en los requisitos de pago en vivo. La indexación de Bazaar es controlada por el facilitador del ecosistema y ocurre solo después de un pago liquidado exitosamente; publicar metadatos por sí solo no es una afirmación de que la indexación haya ocurrido.

Preparación de cotización A2A

El endpoint JSON-RPC de A2A 1.0 implementa SendMessage de forma síncrona. Envía Content-Type: application/json y A2A-Version: 1.0, con exactamente una parte estructurada data que contenga idempotency_key y el mismo intent de pago utilizado por HTTP o MCP. Repetir la misma clave de idempotencia e intención reutiliza la cotización. La respuesta es un Message de agente directo que contiene la cotización vinculada validada y las instrucciones exactas de compra. No autoriza el pago ni ejecuta trabajo pagado; el agente que llama debe evaluar y satisfacer de forma independiente el desafío x402 posterior.

Este adaptador no crea deliberadamente registros A2A Task. Por lo tanto, ListTasks devuelve una colección vacía, mientras que GetTask, CancelTask y un SendMessage que contenga taskId devuelven TaskNotFoundError. La transmisión en streaming, las notificaciones push y las tarjetas de agente extendidas se declaran no admitidas y devuelven los errores de capacidad A2A correspondientes en lugar de simular que esas funciones existen.

Agentes de navegador

La página de destino carga un puente WebMCP de mismo origen con detección de funciones. En navegadores que exponen document.modelContext o navigator.modelContext, este mapea el resultado MCP tools/list en vivo a herramientas del navegador y envía llamadas de vuelta al mismo endpoint MCP. En otros navegadores es un no-op seguro.

Referencias legibles por máquina