Ontario Protocol

Como tornar um endpoint x402 descobrível para agentes

Um endpoint x402 pode aceitar pagamento e ainda assim ser invisível para agentes. Torne o serviço legível em metadados legíveis por máquina, catálogos MCP, GitHub e evidências públicas de prontidão antes de pedir a um registro ou agente que o escolha.

Execute o scorecard gratuito do catálogo Gere metadados de lançamento gratuitamente Solicite a revisão qualificada de $199

Publique um contrato de máquina coerente

Os agentes comparam várias superfícies antes de gastar. A origem do seu serviço deve expor os metadados x402 apropriados à sua implementação, enquanto sua listagem MCP, OpenAPI, README e desafio de pagamento concordam sobre propósito, método, preço, ativo e rede.

• Publique o manifesto x402 do serviço e mantenha seu preço, ativo, rede e recurso atualizados.
• Para MCP, exponha um remoto HTTPS estável e um server.json de registro com nomes e descrições exatas de ferramentas.
• Vincule o relatório público de prontidão em vez de usar um selo ou alegação de lançamento como única prova.

Faça todas as superfícies de descoberta concordarem

Uma listagem de registro é apenas um ponto de entrada. Os agentes precisam de um caminho curto da descoberta à verificação, política e decisão de pagamento sem adivinhar qual URL ou valor é autoritativo.

• Coloque o comando do verificador e o link do relatório no README do GitHub ao lado da descrição do endpoint.
• Use o guia de compra para agentes e a política de pagamento da Ontario como superfícies de referência para decisões de pré-voo.
• Não prometa posicionamento, classificação, segurança ou tráfego de agentes no registro; esses resultados não são controlados apenas por metadados.

Prove prontidão antes da promoção

Execute o scorecard gratuito, o verificador de prontidão e as verificações de desafio de pagamento antes de enviar a um catálogo. Reexecute-os após qualquer alteração de preço, rede, facilitador ou esquema de ferramenta.

• Salve o ID do relatório e inspecione avisos, atualidade, integridade e texto de remediação.
• Use um sandbox ou testnet para ensaio; nunca inclua chaves privadas ou frases-semente em uma varredura.
• Se a evidência pública precisar de reparo coordenado, solicite a revisão de lançamento de escopo fixo de $199 após a qualificação gratuita.

Caminho de verificação pronto para cópia

Use isto como ponto de partida em um README de provedor. Substitua a URL do serviço, inspecione o resultado e mantenha o link do relatório público atualizado.

# 1. Publish and inspect your machine-readable surfaces
curl -sS https://YOUR_SERVICE/.well-known/x402.json
curl -sS https://ontarioprotocol.com/.well-known/agent-buyer.json

# 2. Verify the endpoint before promotion
curl -sS -X POST https://ontarioprotocol.com/api/verify/x402-readiness \
  -H 'Content-Type: application/json' \
  -d '{"target_url":"https://YOUR_SERVICE/api/paid"}'

# 3. Put the resulting public report URL in your README and listing copy

Fluxo de trabalho

Publique o manifesto atual do endpoint, OpenAPI, metadados MCP e links de política voltados ao comprador.

Teste o endpoint sem pagamento e confirme que seu desafio HTTP 402 é estruturado e intencional.

Execute o scorecard gratuito do catálogo e o verificador de prontidão da Ontario; mantenha a URL do relatório público.

Copie o link do relatório, o comando do verificador e os fatos exatos do endpoint para o README e o rascunho do registro.

Envie ou promova apenas sob a política de registro do próprio operador e depois verifique novamente a atualidade após alterações.