Scout Packs

npx add-mcp 'https://scout-packs-production.up.railway.app/mcp'

Scout Packs — Operações Tiger

Pacotes de leads B2B verificados e consultas de enriquecimento por lead vendidos a agentes de IA via x402 (USDC na Base, eip155:8453). Precificação de sonda de demanda (2026-10-04): US$ 0,01 por consulta ou pacote. A inversão de margem vs. custo dos produtos Scout é reconhecida — isto é uma sonda de demanda, não um modelo de negócio. Critério de descontinuação: ≥3 consultas pagas de ≥2 carteiras distintas em 7 dias após o reajuste.

Pacote	Leads	Preço	Entrega
scout-pack-25	25	US$ 0,01	download JSON instantâneo após o pagamento
scout-pack-50	50	US$ 0,01	montado sob demanda, entregue em até 24h
scout-pack-100	100	US$ 0,01	montado sob demanda, entregue em até 24h

Enriquecimento por lead: GET /lookup?query=<company or domain> — paywall 402, US$ 0,01 USDC, POST /fulfill-lookup retorna um e-mail comercial verificado + URL de origem + proveniência.

Cada lead: company_name, city_state, category, contact_email (e-mail comercial verificado), source_url.

Endpoints

• GET / — página de destino humana
• GET /catalog — pacotes e preços (JSON)
• GET /.well-known/x402 — termos de pagamento legíveis por máquina
• GET /llms.txt — instruções de compra para agentes
• GET /packs/{25,50,100}/preview — pré-visualização editada (e-mails mascarados), gratuita
• GET /packs/{25,50,100} — 402 com cabeçalhos PAYMENT-REQUIRED (v2) + X-PAYMENT-REQUIRED (v1)
• GET /lookup?query=<company or domain> — 402 com termos de pagamento (US$ 0,01 USDC); sem correspondência → 404
• POST /fulfill — {"tx_hash":"0x...","pack":"25","deliver_to":"..."}
• POST /fulfill-lookup — {"tx_hash":"0x...","query":"<company>"}
• GET /skill.md — arquivo de habilidade do agente para a consulta de leads (markdown)
• /mcp — endpoint MCP streamable-HTTP (proxiado para o servidor MCP irmão quando MCP_PROXY_PORT estiver definido)

Referência de interface (para clientes agente/MCP)

GET /packs/{25,50,100} → 402 Payment Required

• Cabeçalhos: PAYMENT-REQUIRED = base64(JSON x402 v2 terms), X-PAYMENT-REQUIRED = base64(JSON x402 v1 terms)
• Corpo: {error:"payment_required", pack, leads, price_usd, currency:"USDC", network:"eip155:8453", fulfillment, sales_enabled, x402:{x402Version:2, accepts:[{scheme:"exact", network, amount (atomic USDC, 6 decimals), description, mimeType, payTo, maxTimeoutSeconds, asset, extra}], resource:{url, description, mimeType}}, how_to_pay:[...]}
• sales_enabled:false enquanto o endereço do vendedor não estiver configurado (estado atual); alterna automaticamente quando definido.

POST /fulfill — corpo {tx_hash:"0x…", pack:"25"|"50"|"100", deliver_to:"…" (optional)}

• Sucesso, pacote 25 → 200 {receipt:"ok", pack:"scout-pack-25", tx_hash, verified_at, leads:{…25-lead pack JSON…}}
• Sucesso, pacote 50/100 → 200 {receipt:"ok", pack, tx_hash, verified_at, order_id, status:"queued_for_assembly", eta:"within 24 hours of payment confirmation", deliver_to, note}
• Falha → 402 {error:"payment_not_verified", detail:"sales_paused: receiving address not configured" | "bad_tx_hash" | "already_redeemed" | "tx_not_found" | "tx_not_successful" | "tx_too_old" | "no_matching_usdc_transfer" | "chain_lookup_failed", pay:[…steps…]} ou 400 {error:"unknown_pack"|"bad_json"}

Regras de verificação: a transação deve ser uma transferência USDC bem-sucedida na Base de valor ≥ o valor do pacote para o endereço de recebimento configurado, minerada há <30 dias, e cada hash de transação é de uso único.

Fluxo de compra

1. GET /packs/25 → leia os termos 402 (payTo, valor exato em USDC).
2. x402 padrão: assine uma autorização EIP-3009 para exatamente US$ 0,01 USDC na Base para payTo e repita a mesma solicitação com a assinatura no cabeçalho X-PAYMENT (v1) ou PAYMENT-SIGNATURE (v2). O pagamento é verificado + liquidado via facilitador e o pacote 25 é retornado imediatamente (50/100 retornam um recibo de pedido de 24h).
3. Alternativa: envie exatamente US$ 0,01 USDC na Base para payTo você mesmo e depois POST /fulfill com o hash da transação.

O pagamento é verificado on-chain (API gratuita do Blockscout): a transação deve ser uma transferência USDC bem-sucedida de valor ≥ o valor do pacote para o endereço de recebimento. Hashes de transação são de uso único (protegidos contra replay); transações com mais de 30 dias são rejeitadas.

Configuração

• SCOUTPACKS_RECEIVING_ADDRESS — o endereço na Base que recebe USDC. Enquanto não definido (ou endereço zero), o endpoint opera em modo somente pré-visualização: sales_enabled=false em corpos 402 e /.well-known/x402, e /fulfill recusa todas as solicitações.
• SCOUTPACKS_PUBLIC_BASE — URL pública usada nos campos resource do 402.
• PORT — padrão 8000.
• MCP_PROXY_PORT — opcional (ex.: 8001); quando definido, /mcp faz proxy reverso para o servidor MCP streamable-HTTP irmão (mcp/http_server.py) nessa porta — uma única implantação expõe tanto a API x402 quanto um endpoint MCP HTTPS durável.

Implantação

./run.sh &                                   # localhost:8000

Produção (desde 2026-10-02) roda na Railway — https://scout-packs-production.up.railway.app é o único endpoint de produção. O caminho antigo do localtunnel (lt-proxy.js, subdomínios loca.lt) é legado morto, aposentado em 2026-10-02 após 503s crônicos. Em infraestrutura normal para uma nova implantação, cloudflared tunnel --url http://127.0.0.1:8000 funciona como de costume.

Depois registre nos índices abertos, ex.: 402 Index: POST https://402index.io/api/v1/register com {url, name, protocol:"x402", description, price_usd, payment_asset:"USDC", payment_network:"eip155:8453", category:"data", tags:[...]}.

Servidor MCP (para clientes agente)

Agentes de IA também podem descobrir e comprar pacotes de dentro de clientes MCP (Claude Desktop, Cursor, MCP Inspector, frameworks de agentes) via o servidor MCP em mcp/:

• list_packs — gratuito. Tamanhos de pacotes, preços, status de vendas ao vivo, amostra editada.
• buy_pack — retorna os termos exatos de pagamento x402 e o fluxo passo a passo; a carteira do próprio agente comprador paga o endpoint. Nunca move fundos, nunca guarda chaves.

Início rápido (Python 3.10+, instala apenas o SDK mcp):

cd mcp && python3 -m venv .venv && .venv/bin/pip install mcp
BASE_URL=https://<endpoint-url> .venv/bin/python scout_packs_mcp.py

Ou, uma vez publicado no PyPI: uvx scout-packs-mcp com BASE_URL definido. Documentação completa: mcp/README.md. Listagens em registros: mcp/REGISTRIES.md.