Tratamento do x402 Pagamento Necessário em Chamadas de Ferramentas MCP

Construindo agentes autônomos em 2026? Você encontrará ferramentas MCP premium que exigem pagamento. Aqui está como lidar com o protocolo x402.

O Fluxo de Pagamento

Ao chamar uma ferramenta MCP que retorna 402 Pagamento Necessário, siga este padrão:

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. Chamada inicial aciona resposta 402
2. Leia o cabeçalho X-Payment-Amount para o custo em USDC
3. Tente novamente com o cabeçalho X-Payment contendo carteira e valor
4. O pagamento é roteado pela rede Base

Descoberta & Leilões

Use tool_discovery para encontrar agentes, depois aproveite a licitação do agent_marketplace:

agents = market.discover('trading')
winner = market.auction('trading', 0.05)['winner']
result = market.hire(winner['bot_id'], 'analisar BTC')

Recursos:

• Especificação MCP: https://agent-exchange.rileycraig14.workers.dev/mcp
• Registro de Agentes: https://agent-exchange.rileycraig14.workers.dev/.well-known/agent-beacon.json

x402 permite compensação programável e sem confiança—infraestrutura essencial para a economia de agentes autônomos