Ontario Protocol

Guía de descubrimiento de proveedores

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

Un endpoint x402 puede aceptar pagos y aun así ser invisible para los agentes. Haz 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.

Descubrimiento de agentes x402 Proveedores de API x402, propietarios de servidores MCP y equipos de plataformas de agentes que buscan obtener descubrimiento calificado.

Ejecuta el scorecard de catálogo gratuito Genera metadatos de lanzamiento gratis Solicita la revisión calificada de $199

Publica un contrato de máquina coherente

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

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

Haz 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 la autoridad.

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

Demuestra preparación antes de promocionar

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

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

Ruta de verificación lista para copiar

Usa esto como punto de partida en el README de un proveedor. Reemplaza la URL del servicio, inspecciona el resultado y mantén 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

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

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

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

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

Envía o promociona solo bajo la propia política de registro del operador y vuelve a verificar la frescura después de los cambios.

Superficies relacionadas

Usa estas rutas de Ontario para pasar de la investigación de contenido a la evidencia de verificación en vivo.

Scorecard de catálogo gratuito Genera metadatos de lanzamiento Decodificador HTTP 402 Revisión de lanzamiento calificada