Scout Packs

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

Scout Packs — Operaciones Tiger

Paquetes de leads B2B verificados y búsquedas de enriquecimiento por lead vendidos a agentes de IA a través de x402 (USDC en Base, eip155:8453). Precio de prueba de demanda (2026-10-04): $0.01 por búsqueda o paquete. Se reconoce la inversión de margen frente al COGS de Scout — esto es una prueba de demanda, no un modelo de negocio. Umbral de cancelación: ≥3 búsquedas pagadas desde ≥2 billeteras distintas en 7 días posteriores al nuevo precio.

Paquete	Leads	Precio	Cumplimiento
scout-pack-25	25	$0.01	descarga JSON instantánea después del pago
scout-pack-50	50	$0.01	ensamblado bajo demanda, entregado dentro de 24h
scout-pack-100	100	$0.01	ensamblado bajo demanda, entregado dentro de 24h

Enriquecimiento por lead: GET /lookup?query=<company or domain> — muro de pago 402, $0.01 USDC, POST /fulfill-lookup devuelve un correo electrónico empresarial verificado + URL de origen + procedencia.

Cada lead: company_name, city_state, category, contact_email (correo electrónico empresarial verificado), source_url.

Endpoints

• GET / — página de destino humana
• GET /catalog — paquetes y precios (JSON)
• GET /.well-known/x402 — términos de pago legibles por máquina
• GET /llms.txt — instrucciones de compra para agentes
• GET /packs/{25,50,100}/preview — vista previa redactada (correos enmascarados), gratuita
• GET /packs/{25,50,100} — 402 con encabezados PAYMENT-REQUIRED (v2) + X-PAYMENT-REQUIRED (v1)
• GET /lookup?query=<company or domain> — 402 con términos de pago ($0.01 USDC); sin coincidencia → 404
• POST /fulfill — {"tx_hash":"0x...","pack":"25","deliver_to":"..."}
• POST /fulfill-lookup — {"tx_hash":"0x...","query":"<company>"}
• GET /skill.md — archivo de habilidades del agente para la búsqueda de leads (markdown)
• /mcp — endpoint MCP streamable-HTTP (proxy al servidor MCP hermano cuando MCP_PROXY_PORT está configurado)

Referencia de interfaz (para clientes agente/MCP)

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

• Encabezados: PAYMENT-REQUIRED = base64(JSON x402 v2 terms), X-PAYMENT-REQUIRED = base64(JSON x402 v1 terms)
• Cuerpo: {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 mientras la dirección del vendedor no esté configurada (estado actual); cambia automáticamente una vez configurada.

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

• Éxito, paquete 25 → 200 {receipt:"ok", pack:"scout-pack-25", tx_hash, verified_at, leads:{…25-lead pack JSON…}}
• Éxito, paquete 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}
• Falla → 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…]} o 400 {error:"unknown_pack"|"bad_json"}

Reglas de verificación: la transacción debe ser una transferencia exitosa de USDC en Base de ≥ el monto del paquete a la dirección receptora configurada, minada hace <30 días, y cada hash de transacción es de un solo uso.

Flujo de compra

1. GET /packs/25 → leer los términos 402 (payTo, monto exacto en USDC).
2. x402 estándar: firmar una autorización EIP-3009 por exactamente $0.01 USDC en Base a payTo y reintentar la misma solicitud con la firma en el encabezado X-PAYMENT (v1) o PAYMENT-SIGNATURE (v2). El pago se verifica + liquida a través del facilitador y el paquete 25 se devuelve inmediatamente (50/100 devuelven un recibo de pedido de 24h).
3. Alternativa: enviar exactamente $0.01 USDC en Base a payTo usted mismo, luego POST /fulfill con el hash de la transacción.

El pago se verifica en cadena (API gratuita de Blockscout): la transacción debe ser una transferencia exitosa de USDC de ≥ el monto del paquete a la dirección receptora. Los hashes de transacción son de un solo uso (protegidos contra reproducción); las transacciones de más de 30 días se rechazan.

Configuración

• SCOUTPACKS_RECEIVING_ADDRESS — la dirección Base que recibe USDC. Mientras no esté configurada (o sea la dirección cero), el endpoint funciona en modo solo vista previa: sales_enabled=false en cuerpos 402 y /.well-known/x402, y /fulfill rechaza todas las solicitudes.
• SCOUTPACKS_PUBLIC_BASE — URL pública utilizada en campos 402 resource.
• PORT — predeterminado 8000.
• MCP_PROXY_PORT — opcional (p. ej. 8001); cuando está configurado, /mcp hace proxy inverso al servidor MCP streamable-HTTP hermano (mcp/http_server.py) en ese puerto — una sola implementación expone tanto la API x402 como un endpoint MCP HTTPS duradero.

Implementación

./run.sh &                                   # localhost:8000

Producción (desde 2026-10-02) se ejecuta en Railway — https://scout-packs-production.up.railway.app es el único endpoint de producción. La ruta antigua de localtunnel (lt-proxy.js, subdominios loca.lt) es legado muerto, retirada 2026-10-02 después de 503 crónicos. En infraestructura normal para una implementación nueva, cloudflared tunnel --url http://127.0.0.1:8000 funciona como de costumbre.

Luego registrarse en los índices abiertos, p. ej. 402 Index: POST https://402index.io/api/v1/register con {url, name, protocol:"x402", description, price_usd, payment_asset:"USDC", payment_network:"eip155:8453", category:"data", tags:[...]}.

Servidor MCP (para clientes agente)

Los agentes de IA también pueden descubrir y comprar paquetes desde dentro de clientes MCP (Claude Desktop, Cursor, MCP Inspector, marcos de agentes) a través del servidor MCP en mcp/:

• list_packs — gratuito. Tamaños de paquetes, precios, estado de ventas en vivo, muestra redactada.
• buy_pack — devuelve los términos de pago x402 exactos y el flujo paso a paso; la billetera del agente comprador paga el endpoint. Nunca mueve fondos, nunca retiene claves.

Inicio rápido (Python 3.10+, instala solo el 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

O una vez publicado en PyPI: uvx scout-packs-mcp con BASE_URL configurado. Documentación completa: mcp/README.md. Listados de registro: mcp/REGISTRIES.md.