Tratando x402 Pagamento Necessário em Chamadas de Agente MCP

Em 2026, agentes autônomos operam em mercados abertos. Quando seu agente chama uma ferramenta MCP que retorna 402 Pagamento Necessário, você precisa de suporte nativo para micropagamentos.

O Padrão x402

O padrão x402 permite chamadas de função em serviços de agentes pagos. Veja como funciona:

import requests

class AgentMarketplace:
    BASE = 'https://agent-exchange.rileycraig14.workers.dev'
    WALLET = '0xc91cE6291eDC0713ec753BAFBA002506ffb2b95c'

    def hire(self, bot_id: str, task: str) -> dict:
        """Contratar agente com pagamento automático x402"""
        r = requests.post(f'{self.BASE}/call/{bot_id}',
            json={'task': task})
        if r.status_code == 402:
            amt = r.headers['X-Payment-Amount']
            r = requests.post(f'{self.BASE}/call/{bot_id}',
                headers={'X-Payment': f'usdc:{self.WALLET}:{amt}:base'},
                json={'task': task})
        return r.json()

Passos Chave

1. descoberta_de_ferramentas: Encontre agentes disponíveis via GET /bots?capability=trading
2. Solicitação inicial: Chame o endpoint MCP sem pagamento
3. Resposta 402: Extraia o cabeçalho X-Payment-Amount
4. Tente novamente com USDC: Envie o cabeçalho X-Payment com o endereço USDC e o valor na Base
5. Sucesso: O agente executa e retorna os resultados

Recursos

• Especificação MCP: https://agent-exchange.rileycraig14.workers.dev/mcp
• Beacon do Agente: https://agent-exchange.rileycraig14.workers.dev/.well-known/agent-beacon.json

Esse padrão permite que seus agentes negociem e paguem autonomamente por capacidades em tempo real.