Verified x402 Catalog

Quais endpoints x402 de pagamento por chamada entregaram uma tarefa por um preço. MCP remoto gratuito.

GitHubExperimente este MCPPatrocinado

Documentação

Catálogo Verificado de Pagamento por Chamada

Um catálogo estático e legível por máquina de serviços de pagamento por chamada (x402) para agentes de IA, com resultados factuais de nossas próprias verificações automatizadas. Publicado por @WithGrokBot.

Experimente em uma linha

Qual endpoint de busca web x402 entregou em nossas últimas chamadas pagas, a US$ 0,01 ou menos? Sem chave; 5 consultas gratuitas por cliente por dia 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();

Os resultados são ordenados pela taxa de aprovação de respostas conhecidas em nossas últimas chamadas pagas e, em seguida, pelo preço, cada um com seus recibos de liquidação na Base. Outras tarefas: /v1/tasks. client=<your agent name> opcional; ref apenas indica onde você encontrou o link.

Preços

  • 5 consultas gratuitas por cliente por dia UTC. O cliente é o valor do seu client quando você envia um; caso contrário, um hash com sal do seu IP (IPs brutos nunca são armazenados). O contador é redefinido às 00:00 UTC. Apenas /v1/lookup é medido; /v1/tasks, /openapi.json e os arquivos estáticos do catálogo permanecem gratuitos.
  • Depois disso, US$ 0,02 USDC na Base por consulta via x402. A consulta responde com HTTP 402 e um cabeçalho PAYMENT-REQUIRED v2 (esquema exact, eip155:8453, USDC, payTo 0x37cfCC8a29e9ff9458902B29E31E42dc7B718674). Repita com um cabeçalho PAYMENT-SIGNATURE (ou X-PAYMENT); o pagamento é verificado e liquidado por meio do facilitador público PayAI x402, e a transação de liquidação retorna no cabeçalho PAYMENT-RESPONSE e no bloco access da resposta.
  • O pagamento nunca altera resultados, ordem de classificação ou listagens. Ele compra apenas acesso à consulta. Consultas gratuitas, pagas e isentas executam o mesmo código nos mesmos dados e obtêm resultados idênticos; nenhum vendedor pode pagar por posicionamento, e nenhum resultado de verificação ou resposta conhecida depende de quem pagou. Cada resposta de consulta repete isso em payment_policy.

Servidor MCP remoto (gratuito)

https://verified-catalog-lookup.withgrokbot.workers.dev/mcp (HTTP Streamable, JSON-RPC sem estado, sem chave). As mesmas 3 ferramentas e resultados que mcp/server.py: search_catalog, get_service e lookup. lookup usa o nome do cliente vc-mcp, portanto compartilha as 5 consultas gratuitas desse cliente por dia UTC; depois disso, ele relata o 402 e não paga. Nome do registro: io.github.withgrokbot/verified-catalog (server.json).

Endpoint sempre pago (x402)

GET https://verified-catalog-lookup.withgrokbot.workers.dev/v1/lookup/paid?task=web-search&max_price=0.01 aceita os mesmos parâmetros e retorna o mesmo resultado que /v1/lookup, por US$ 0,02 USDC na Base por chamada, sem cota gratuita. Seu 402 carrega metadados de descoberta do x402 Bazaar (extensions.bazaar); também está listado em /openapi.json (x-payment-info) e /.well-known/x402. Parâmetros inválidos geram um 400 antes de qualquer liquidação.

Produtos

Downloads digitais pagos vendidos pelo mesmo Worker via x402 (sempre pagos; a cota gratuita de consultas e SELF_CLIENTS não se aplicam):

  • Pacote de Configuração de Chefe de Gabinete Noturno — $9 USDC na Base. GET https://verified-catalog-lookup.withgrokbot.workers.dev/v1/products/overnight-cos-pack (ou ferramenta MCP get_overnight_cos_pack). Chamadas não pagas retornam HTTP 402 com metadados de descoberta do Bazaar. Após o pagamento: prompts, modelo de briefing matinal em HTML e guia em PDF.

Arquivos

  • index.html, services/<id>.html, methodology.html: o site (sem JavaScript, sem solicitações a outros hosts)
  • catalog.json, services/<id>.json, llms.txt, .well-known/agent-card.json: legíveis por máquina
  • data/services.json: as listagens iniciais (fonte e data de recuperação em cada uma), data/site.json: configurações de marca/repositório
  • results/latest.json, results/history.jsonl, results/raw/<run>/<id>.json, results/spend_ledger.json: resultados de verificação e evidências
  • scripts/run_checks.py: executa verificações (gratuito/simulação por padrão) e reconstrói; scripts/build_site.py: apenas reconstrói
  • data/quality_tests.json, scripts/quality.py: testes de respostas conhecidas executados em cada chamada paga (aprovado/reprovado; serviços quebrados são "apenas fatos")
  • receipts.json: cada chamada paga (hora, cobrança, transação de liquidação com link do Basescan, entrega, resultado de resposta conhecida)
  • worker/: consulta de confiabilidade, um Cloudflare Worker (GET /v1/lookup?task=web-search&max_price=0.01&n=5) que lê catalog.json e receipts.json deste site e conta clientes distintos (veja worker/README.md)
  • mcp/server.py: pequeno servidor MCP stdio com search_catalog, get_service (lê catalog.json) e lookup (chama o Worker); o Worker serve as mesmas ferramentas remotamente em /mcp
  • server.json: entrada oficial do Registro MCP (servidor remoto)
  • scripts/demand_weekly.py: contagem semanal de clientes de consulta distintos -> results/demand_weekly.json
  • .github/workflows/daily.yml: verificações gratuitas diárias e commit

Execução

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)

Verificações pagas existem, mas estão desativadas por padrão. Elas exigem --pay, um arquivo de carteira fora desta pasta (--wallet) e pip install -r scripts/requirements-pay.txt. Limites rígidos: US$ 0,10 por chamada, US$ 1,00 por dia UTC, US$ 20,00 vitalício; apenas USDC "exato" na Base é assinado.

Publicamos apenas fatos, sem notas. Não mantemos fundos de clientes e não somos parte em nenhuma transação de vendedor; taxas de consulta após o nível gratuito vão para nossa própria carteira. Para contestar um resultado, abra uma issue no GitHub (veja methodology.html#contest).

Licença

MIT, veja LICENSE.