Como adicionar ferramentas de dados pay-per-call x402 ao seu agente Claude Code — sem necessidade de chave API

A maioria das APIs de dados cobra uma taxa mensal. Seu agente pode chamar o endpoint duas vezes em um mês, mas você ainda está pagando a assinatura completa. Existe um modelo melhor.

x402 é um protocolo de pagamento HTTP baseado no código de status HTTP 402 — um código que está na especificação desde 1996, mas nunca foi implementado em grande escala até agora. A Coinbase construiu a camada facilitadora no ano passado. O protocolo está ativo na mainnet Base. Agentes de IA agora podem pagar exatamente pelo que usam, em USDC, sem necessidade de conta ou chave de API.

Eu construí The Stall em torno desse protocolo — um servidor MCP ao vivo com 32 capacidades de dados, cada uma com preço por chamada em USDC. Aqui está como integrá-lo ao Claude Code em cerca de 3 minutos, e como o x402 realmente se parece no ciclo de requisição.

Como o x402 funciona

O fluxo é simples:

1. Seu agente envia uma requisição HTTP normal para um endpoint de capacidade
2. O servidor responde com HTTP 402 + um desafio de pagamento (um blob JSON descrevendo valor, moeda, facilitador, endereço do destinatário)
3. Seu cliente habilitado para x402 lê o desafio, constrói um cabeçalho de pagamento USDC assinado e reenvia a requisição original com o cabeçalho X-Payment anexado
4. O servidor verifica o pagamento com o facilitador Coinbase e retorna os dados
5. O agente recebe de volta JSON estruturado — e um recibo nos cabeçalhos da resposta

O SDK TypeScript x402 lida automaticamente com as etapas 2–4 se você estiver construindo um agente codificado. Para o Claude Code usando MCP, o servidor gerencia isso de forma transparente através da camada de transporte MCP.

Configuração do Claude Code

Adicione The Stall à sua configuração MCP do Claude Code:

{
  "mcpServers": {
    "the-stall": {
      "url": "https://the-stall.intuitek.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Essa é toda a configuração para a maioria dos casos de uso. Quando Claude roteia uma chamada de ferramenta através do The Stall, o transporte MCP lida com o ciclo de pagamento x402 — seu agente não precisa implementar nada.

Para agentes programáticos que chamam os endpoints REST diretamente, adicione o SDK x402:

npm install x402

import { wrapFetchWithPayment } from "x402/client";

// Financie esta carteira com alguns dólares de USDC na mainnet Base
const payingFetch = wrapFetchWithPayment(fetch, walletClient);

const response = await payingFetch(
  "https://the-stall.intuitek.ai/cap/us-stock-price?symbol=AAPL"
);
const data = await response.json();
// dados: { símbolo, preço, mudança_percent, capitalização_mercado, ... }

O que está disponível

32 capacidades no catálogo atual (https://the-stall.intuitek.ai/catalog). Preços por chamada: