Agent Verification Utility

Verificações determinísticas de JSON com evidência assinada e execução paga por x402

Ver em kgninja.devExperimente este MCPPatrocinado

Documentação

Interoperabilidade MCP e x402

Um fluxo de compra machine-first que mantém descoberta e cotação gratuitas, cobrando apenas pela execução determinística.

Transporte MCP público

O endpoint HTTP Streamable sem estado é https://agent-economy.kgninja.dev/mcp.. Um cliente pode chamar tools/list sem autenticação. As ferramentas gratuitas são describe_verify_evidence, get_revenue_goal_status, quote_verify_evidence e prepare_verify_evidence_purchase. A ferramenta paga é verify_evidence.

Sequência da ferramenta paga

  1. Envie POST { request, spend_policy } para a pré-verificação gratuita e copie o digest do recibo para a intenção paga.
  2. Chame verify_evidence com uma chave de idempotência única e essa intenção completa.
  3. Uma chamada não paga retorna um erro de ferramenta MCP cujo _meta["x402/error"] contém um documento PaymentRequired x402 v2 e um binding de verificação pago.
  4. Valide o hash da pré-verificação, o digest do binding, o teto de preço, a versão da política, o digest de evidência, a expiração da cotação, o esquema, a rede CAIP-2, o ativo, o valor e o endereço de recebimento contra a política local.
  5. Assine um requisito suportado com um cliente compatível com x402 somente quando todos os campos ainda corresponderem.
  6. Repita a chamada de ferramenta idêntica com o pagamento codificado em _meta["x402/payment"].
  7. Preserve _meta["x402/payment-response"], o binding entregue com o ID do recibo pago e a evidência assinada.

A rota HTTP https://agent-economy.kgninja.dev/verify-evidence pode criar sua própria cotação vinculada apenas a partir de uma intenção paga completa e retornar PAYMENT-REQUIRED diretamente; sondagens vazias ou de requisição bruta falham antes que uma cotação ou requisito de pagamento seja criado. Chamar https://agent-economy.kgninja.dev/quote primeiro continua disponível para pré-voo econômico explícito. Ambos os modos usam cabeçalhos PAYMENT-SIGNATURE e PAYMENT-RESPONSE equivalentes e exigem o mesmo digest de binding.

Superfícies de descoberta

A extensão x402 Bazaar está presente em requisitos de pagamento ativos. A indexação do Bazaar é controlada pelo facilitador do ecossistema e ocorre somente após um pagamento liquidado com sucesso; publicar metadados por si só não é uma afirmação de que a indexação ocorreu.

Preparação de cotação A2A

O endpoint JSON-RPC A2A 1.0 implementa SendMessage síncrono. Envie Content-Type: application/json e A2A-Version: 1.0, com exatamente uma parte estruturada data contendo idempotency_key e o mesmo intent pago usado por HTTP ou MCP. Repetir a mesma chave de idempotência e intenção reutiliza a cotação. A resposta é um Message de agente direto contendo a cotação vinculada validada e instruções exatas de compra. Ele não autoriza pagamento nem executa trabalho pago; o agente chamador deve avaliar e satisfazer de forma independente o desafio x402 posterior.

Este adaptador deliberadamente não cria registros A2A Task. ListTasks portanto retorna uma coleção vazia, enquanto GetTask, CancelTask e um SendMessage contendo taskId retornam TaskNotFoundError. Streaming, notificações push e Cartões de Agente estendidos são declarados como não suportados e retornam os erros de capacidade A2A correspondentes, em vez de fingir que esses recursos existem.

Agentes de navegador

A página inicial carrega uma ponte WebMCP de mesma origem, com detecção de recursos. Em navegadores que expõem document.modelContext ou navigator.modelContext, ela mapeia o resultado MCP tools/list ativo para ferramentas do navegador e faz proxy das chamadas de volta para o mesmo endpoint MCP. Em outros navegadores, é um no-op seguro.

Referências legíveis por máquina