Ontario Protocol

Provider discovery guide

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.

x402 agent discovery provedores de API x402, proprietários de servidores MCP e equipes de plataforma de agentes que buscam ganhar descoberta qualificada.

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

Publique um contrato de máquina coerente

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 do registro com nomes e descrições exatas das 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 cada superfície de descoberta concordar

Uma listagem de registro é apenas um ponto de entrada. 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 de Ontario e a política de pagamento como superfícies de referência para decisões de pré-voo.
• Não prometa colocação em registro, classificação, segurança ou tráfego de agentes; esses resultados não são controlados apenas por metadados.

Prove prontidão antes da promoção

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

• Salve o ID do relatório e inspecione avisos, frescor, integridade e texto de correçã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 qualificada de $199 com escopo fixo após qualificação gratuita.

Caminho de verificação pronto para copiar

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.

Acesse 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 de 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 no README e no rascunho do registro.

Envie ou promova apenas sob a política de registro do próprio operador e verifique o frescor após mudanças.

Superfícies Relacionadas

Use estas rotas de Ontario para passar da pesquisa de conteúdo para evidências de verificação ao vivo.

Scorecard gratuito do catálogo Gere metadados de lançamento Decodificador HTTP 402 Revisão de lançamento qualificada