Verified x402 Catalog

Qué endpoints x402 de pago por llamada se entregaron para una tarea a un precio. MCP remoto gratuito.

GitHub
1

Documentación

Catálogo Verificado de Pago por Llamada

Un catálogo estático y legible por máquina de servicios de pago por llamada (x402) para agentes de IA, con resultados factuales de nuestras propias verificaciones automatizadas. Publicado por @WithGrokBot.

Pruébalo en una línea

¿Qué endpoint de búsqueda web x402 cumplió en nuestras últimas llamadas pagadas, a $0.01 o menos? Sin clave; 5 consultas gratuitas por cliente por día UTC:

curl -s "https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup?task=web-search&max_price=0.01&ref=via-readme"

const r = await (await fetch("https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup?task=web-search&max_price=0.01&ref=via-readme")).json();

Los resultados se ordenan por tasa de aprobación de respuestas conocidas en nuestras últimas llamadas pagadas, luego por precio, cada uno con sus recibos de liquidación en Base. Otras tareas: /v1/tasks. client=<your agent name> opcional; ref solo indica dónde encontraste el enlace.

Precios

  • 5 consultas gratuitas por cliente por día UTC. El cliente es tu valor de client cuando envías uno; de lo contrario, un hash con sal de tu IP (las IPs crudas nunca se almacenan). El contador se reinicia a las 00:00 UTC. Solo /v1/lookup se mide; /v1/tasks, /openapi.json y los archivos estáticos del catálogo permanecen gratuitos.
  • Después, $0.02 USDC en Base por consulta vía x402. La consulta responde con HTTP 402 y un encabezado PAYMENT-REQUIRED v2 (esquema exact, eip155:8453, USDC, payTo 0x37cfCC8a29e9ff9458902B29E31E42dc7B718674). Reintenta con un encabezado PAYMENT-SIGNATURE (o X-PAYMENT); el pago se verifica y liquida a través del facilitador público PayAI x402, y la transacción de liquidación regresa en el encabezado PAYMENT-RESPONSE y en el bloque access de la respuesta.
  • El pago nunca cambia resultados, orden de clasificación ni listados. Solo compra acceso a consultas. Las consultas gratuitas, pagadas y exentas ejecutan el mismo código sobre los mismos datos y obtienen resultados idénticos; ningún vendedor puede pagar por posicionamiento, y ningún resultado de verificación o respuesta conocida depende de quién pagó. Cada respuesta de consulta repite esto en payment_policy.

Servidor MCP remoto (gratuito)

https://verified-catalog-lookup.withgrokbot.workers.dev/mcp (HTTP Streamable, JSON-RPC sin estado, sin clave). Las mismas 3 herramientas y resultados que mcp/server.py: search_catalog, get_service y lookup. lookup usa el nombre de cliente vc-mcp, por lo que comparte las 5 consultas gratuitas de ese cliente por día UTC; después de eso reporta el 402 y no paga. Nombre del registro: io.github.withgrokbot/verified-catalog (server.json).

Endpoint siempre pagado (x402)

GET https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup/paid?task=web-search&max_price=0.01 acepta los mismos parámetros y devuelve el mismo resultado que /v1/lookup, por $0.02 USDC en Base por llamada sin cuota gratuita. Su 402 incluye metadatos de descubrimiento de x402 Bazaar (extensions.bazaar); también está listado en /openapi.json (x-payment-info) y /.well-known/x402. Los parámetros incorrectos reciben un 400 antes de que se liquide cualquier cosa.

Productos

Descargas digitales de pago vendidas a través del mismo Worker vía x402 (siempre pagadas; la cuota de consultas gratuitas y SELF_CLIENTS no aplican):

  • Paquete de Configuración de Jefe de Gabinete Nocturno — $9 USDC en Base. GET https://verified-catalog-lookup.withgrokbot.workers.dev/v1/products/overnight-cos-pack (o herramienta MCP get_overnight_cos_pack). Las llamadas impagas devuelven HTTP 402 con metadatos de descubrimiento de Bazaar. Después del pago: indicaciones, plantilla HTML de informe matutino y guía en PDF.

Archivos

  • index.html, services/<id>.html, methodology.html: el sitio (sin JavaScript, sin solicitudes a otros hosts)
  • catalog.json, services/<id>.json, llms.txt, .well-known/agent-card.json: legibles por máquina
  • data/services.json: los listados semilla (fuente y fecha de recuperación en cada uno), data/site.json: configuración de marca/repositorio
  • results/latest.json, results/history.jsonl, results/raw/<run>/<id>.json, results/spend_ledger.json: resultados de verificación y evidencia
  • scripts/run_checks.py: ejecutar verificaciones (gratis/simulación por defecto) y reconstruir; scripts/build_site.py: solo reconstruir
  • data/quality_tests.json, scripts/quality.py: pruebas de respuestas conocidas ejecutadas en cada llamada pagada (aprobado/fallido; los servicios rotos son "solo hechos")
  • receipts.json: cada llamada pagada (hora, cobro, transacción de liquidación con enlace a Basescan, entrega, resultado de respuesta conocida)
  • worker/: consulta de confiabilidad, un Cloudflare Worker (GET /v1/lookup?task=web-search&max_price=0.01&n=5) que lee catalog.json y receipts.json de este sitio y cuenta clientes distintos (ver worker/README.md)
  • mcp/server.py: pequeño servidor MCP stdio con search_catalog, get_service (lee catalog.json) y lookup (llama al Worker); el Worker sirve las mismas herramientas de forma remota en /mcp
  • server.json: entrada oficial del Registro MCP (servidor remoto)
  • scripts/demand_weekly.py: conteo semanal de clientes de consulta distintos -> results/demand_weekly.json
  • .github/workflows/daily.yml: verificaciones gratuitas diarias y commit

Ejecución

python3 scripts/run_checks.py            # free checks, no payment (default)
python3 scripts/build_site.py            # rebuild pages from data/ and results/
python3 tests/run_tests.py               # acceptance tests (Node 18+ for the Worker tests)

Las verificaciones pagadas existen pero están desactivadas por defecto. Requieren --pay, un archivo de billetera fuera de esta carpeta (--wallet) y pip install -r scripts/requirements-pay.txt. Límites máximos: $0.10 por llamada, $1.00 por día UTC, $20.00 de por vida; solo se firma USDC "exacto" en Base.

Publicamos solo hechos, sin calificaciones. No retenemos fondos de clientes y no somos parte de ninguna transacción de vendedor; las tarifas de consulta después del nivel gratuito van a nuestra propia billetera. Para impugnar un resultado, abre un issue en GitHub (ver methodology.html#contest).

Licencia

MIT, ver LICENSE.