Como Construí um Gateway de Pagamento Pay-Per-Use WebMCP + x402 para Vender Dados Premium a Agentes de IA

Um relato de um praticante sobre a implementação de pagamentos agenticos em um projeto real de fintech: liberando conteúdo premium para agentes de IA com um sistema de pagamento por uso. O que funcionou, o que quebrou e para onde a monetização de conteúdo está indo.

Por Alex Amor · 7 de junho de 2026

Eu venho pensando sobre isso há um tempo: a web suportada por anúncios é um modelo construído em torno de olhos humanos. Impressões de exibição, taxas de cliques, duração da sessão; cada métrica de monetização assume que uma pessoa está do outro lado. Essa suposição está quebrando silenciosamente. Agentes de IA não veem anúncios. Eles não clicam em banners. Eles leem dados estruturados, chamam APIs e seguem em frente. Se uma parte significativa do tráfego da web mudar de humanos navegando para agentes consultando, toda a economia da publicação de conteúdo online mudará com isso.

Agentes de IA não veem anúncios. Eles não clicam em banners. Eles leem dados estruturados, chamam APIs e seguem em frente. O modelo de monetização que se encaixa neles não é impressões, mas pagamentos agenticos: acesso pago por uso, precificado por chamada.

Então eu decidi parar de teorizar e construir algo. A pergunta que eu queria responder: é possível que uma página da web exponha seus dados como ferramentas estruturadas e chamáveis para agentes de IA, e o HTTP 402 (um código de status HTTP que ficou sem uso como um stub por 30 anos) pode realmente funcionar como uma camada de negociação de pagamento real para acesso premium?

O campo de testes foi um projeto pessoal de fintech: um painel de inteligência de opções SPX diário que já gera JSON estruturado todas as manhãs (classificação de regime de mercado, níveis de posicionamento de dealers, uma janela de movimento esperado, um sinal direcional) tornando-o um candidato natural para uma API nativa de agentes. O tipo de dado onde a frescura importa e onde o acesso em camadas (resumo de hoje gratuito, profundidade histórica premium) se encaixa perfeitamente no modelo WebMCP + x402. Dados financeiros são bem adequados para essa arquitetura: o conteúdo é legível por máquinas por natureza, o nível premium é claramente definido e agentes consultando dados de mercado não precisam de uma página de login.

Este post é sobre como eu construí isso, o que aprendi com a fricção e por que eu acho que o padrão se generaliza bem além deste projeto específico.

Para a documentação real do endpoint e da ferramenta, eu coloquei uma referência técnica separada em agent.gexlog.com. Este post é sobre o porquê e o como, não os detalhes operacionais.

As Duas Tecnologias: WebMCP e x402

O registro do WebMCP é acionado na carga da página; a primeira chamada de ferramenta paga do agente retorna um 402 com termos de pagamento legíveis por máquina.

WebMCP é uma API nativa do navegador que permite que uma página da web registre ferramentas tipadas e descritas que agentes de IA podem descobrir e chamar diretamente. Sem scraping, sem adivinhação de DOM, sem modelos de visão interpretando capturas de tela. É um Rascunho do Grupo Comunitário W3C, publicado em fevereiro de 2026, disponível atrás de uma bandeira no Chrome 146 Stable (chrome://flags/#enable-webmcp-testing). A formulação do Google captura isso bem: em vez de um agente olhando para o cardápio de um restaurante estrangeiro, o site entrega a ele um menu.

A API de registro é direta:

document.modelContext.registerTool({

  name: 'get_current_briefing',

  description: "'Retorna hoje\'s full market intelligence snapshot...',"

  inputSchema: { type: 'object', properties: { ... } },

  execute: async (params) => { /* buscar e retornar dados */ }

});

Uma nota prática para quem estiver implementando isso agora: navigator.modelContext está obsoleto a partir do Chrome 150 em favor de document.modelContext. Sua cláusula de guarda deve lidar com ambos durante o período de transição:

const modelContext = document.modelContext || navigator.modelContext;

if (!modelContext || typeof modelContext.registerTool !== 'function') return;

A especificação está ao vivo e em movimento. O código escrito contra ela há três meses pode já precisar de um patch.

x402 é o código de status HTTP 402 Payment Required ressuscitado, reformulado de um stub permanente em um protocolo real de negociação de pagamento: a trilha para pagamentos agenticos, onde software paga software sem um humano no fluxo de checkout. O fluxo: um agente chama um endpoint restrito, recebe um 402 com termos de pagamento legíveis por máquina nos cabeçalhos de resposta, assina uma autorização de transferência USDC com sua carteira e tenta novamente com a prova de pagamento incorporada no cabeçalho X-PAYMENT. Sem criação de conta, sem formulário de inscrição de chave API, sem humano no fluxo de checkout. O pagamento é um passo do protocolo, não um fluxo de UX.

Como essa resposta 402 realmente se parece na rede:

HTTP/1.1 402 Pagamento Necessário

Content-Type: application/json

X-PAYMENT-REQUIRED: <base64-encoded J