Ontario Protocol

Cómo hacer que un endpoint x402 sea descubrible para los agentes

Un endpoint x402 puede aceptar pagos y aun así ser invisible para los agentes. Haga que el servicio sea legible a través de metadatos legibles por máquina, catálogos MCP, GitHub y evidencia pública de preparación antes de pedirle a un registro o agente que lo elija.

Ejecute el scorecard de catálogo gratuito Genere metadatos de lanzamiento gratis Solicite la revisión calificada de $199

Publique un contrato de máquina coherente

Los agentes comparan varias superficies antes de gastar. El origen de su servicio debe exponer los metadatos x402 apropiados para su implementación, mientras que su listado MCP, OpenAPI, README y desafío de pago coinciden en propósito, método, precio, activo y red.

• Publique el manifiesto x402 del servicio y mantenga actualizados su precio, activo, red y recurso.
• Para MCP, exponga un remoto HTTPS estable y un server.json de registro con nombres y descripciones de herramientas exactos.
• Enlace el informe público de preparación en lugar de usar una insignia o afirmación de lanzamiento como única prueba.

Haga que cada superficie de descubrimiento coincida

Un listado de registro es solo un punto de entrada. Los agentes necesitan un camino corto desde el descubrimiento hasta la verificación, la política y una decisión de pago sin adivinar qué URL o monto es autoritativo.

• Coloque el comando verificador y el enlace del informe en el README de GitHub junto a la descripción del endpoint.
• Use la guía de compra para agentes de Ontario y la política de pago como superficies de referencia para decisiones previas al vuelo.
• No prometa colocación en registros, clasificación, seguridad o tráfico de agentes; esos resultados no se controlan solo con metadatos.

Demuestre preparación antes de la promoción

Ejecute el scorecard gratuito, el verificador de preparación y las comprobaciones de desafío de pago antes de enviar a un catálogo. Vuelva a ejecutarlos después de cualquier cambio de precio, red, facilitador o esquema de herramientas.

• Guarde el ID del informe e inspeccione advertencias, frescura, integridad y texto de remediación.
• Use un sandbox o testnet para el ensayo; nunca incluya claves privadas o frases semilla en un escaneo.
• Si la evidencia pública necesita reparación coordinada, solicite la revisión de lanzamiento de alcance fijo de $199 después de la calificación gratuita.

Ruta de verificación lista para copiar

Use esto como punto de partida en el README de un proveedor. Reemplace la URL del servicio, inspeccione el resultado y mantenga actualizado el enlace del informe público.

# 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

Flujo de trabajo

Publique el manifiesto actual del endpoint, OpenAPI, metadatos MCP y enlaces de política orientados al comprador.

Sondee el endpoint sin pago y confirme que su desafío HTTP 402 está estructurado e intencional.

Ejecute el scorecard de catálogo gratuito de Ontario y el verificador de preparación; conserve la URL del informe público.

Copie el enlace del informe, el comando verificador y los hechos exactos del endpoint en el README y el borrador del registro.

Envíe o promueva solo bajo la propia política de registro del operador, y luego vuelva a verificar la frescura después de los cambios.