Ontario Protocol

Capa de preflight y confianza x402 para agentes autónomos

Documentación

Paquete de Listado MCP/x402 del Protocolo Ontario

Ontario Protocol es una superficie de preflight de pago x402 y de confianza para agentes autónomos. Expone herramientas compatibles con MCP para descubrimiento, verificaciones gratuitas de disponibilidad y herramientas de confianza de pago, para que los agentes puedan verificar los metadatos del servicio antes de pagar.

Página de inicio: https://ontarioprotocol.com

Manifiesto MCP: https://ontarioprotocol.com/.well-known/mcp.json

Endpoint MCP remoto: https://ontarioprotocol.com/mcp

Manifiesto x402: https://ontarioprotocol.com/.well-known/x402.json

Guía para el comprador agente: https://ontarioprotocol.com/.well-known/agent-buyer.json

Descubrimiento: https://ontarioprotocol.com/discover

Verificador gratuito de disponibilidad: https://ontarioprotocol.com/verify

Siguiente paso gratuito para el propietario: https://ontarioprotocol.com/api/mcp-owner-next-step

Verificación de idoneidad para revisores de directorio / propietarios de endpoints: https://github.com/thom899g/ontario-protocol-mcp-listing/issues/new?template=endpoint_owner_fit_check.yml

Paquete de listado descargable: https://github.com/thom899g/ontario-protocol-mcp-listing/releases/download/v0.1.2/ontario-listing-packet-v0.1.2.zip

Ruta Más Rápida y Segura para el Comprador

Use esta ruta si usted es un agente, un rastreador de directorios o un propietario de endpoint que intenta decidir si Ontario merece una llamada de pago real:

  1. Confirme los manifiestos públicos:
  2. Pruebe el endpoint de pago más económico sin pagar:
    • GET https://ontarioprotocol.com/api/x402/reputation/demo-agent
    • Esperado: desafío de pago HTTP 402 para 0.001 USDC en Base.
  3. Ejecute la verificación de política gratuita antes de cualquier acción de billetera:
    • POST https://ontarioprotocol.com/api/agent/can-pay
  4. Si usted posee un endpoint MCP/x402, solicite una verificación de idoneidad pública gratuita:
  5. Realice una llamada de pago solo después de que su propia política permita la liquidación USDC-en-Base y pueda almacenar la cotización/recibo de pago.

Límite actual: Ontario tiene inspección pública de rastreadores/herramientas de desarrollo y una prueba de riel 0.01 USDC autofinanciada, pero aún no tiene una llamada de pago verificada de un cliente. Una señal de mercado válida es un listado aceptado, un rechazo, una obtención por rastreador, una solicitud de propietario de endpoint, una llamada de pago, un registro o un pago.

Descripción Recomendada para el Directorio

Ontario Protocol expone herramientas MCP y x402 para verificar endpoints de agentes de pago antes de que los agentes paguen. Comience con herramientas gratuitas de disponibilidad y capacidad de pago, luego use las herramientas de confianza, reputación y listado de pago solo después de que la política lo permita.

Herramientas

HerramientaMétodoEndpointPrecio
agent_can_payPOSThttps://ontarioprotocol.com/api/agent/can-paygratis
x402_readiness_verifyPOSThttps://ontarioprotocol.com/api/verify/x402-readinessgratis
agent_verify_paymentPOSThttps://ontarioprotocol.com/api/agent/verify-paymentgratis
discoverGEThttps://ontarioprotocol.com/discovergratis
agent-trust-scanPOSThttps://ontarioprotocol.com/api/x402/agent-trust-scan0.01 USDC
reputation-lookupGEThttps://ontarioprotocol.com/api/x402/reputation/{agent_id}0.001 USDC
list-agentPOSThttps://ontarioprotocol.com/api/x402/list-agent0.10 USDC
list-servicePOSThttps://ontarioprotocol.com/api/x402/list-service0.50 USDC

Si una Sonda de Pago Devuelve HTTP 402

Comience con la prueba de pago más económica y luego use el preflight gratuito antes de firmar:

curl -i https://ontarioprotocol.com/api/x402/reputation/demo-agent
curl -fsSL -X POST https://ontarioprotocol.com/api/agent/can-pay \
  -H 'content-type: application/json' \
  -d '{"endpoint":"https://ontarioprotocol.com/api/x402/reputation/demo-agent","max_usdc":"0.001","agent_policy":"standard"}'

Límite esperado:

  • GET /api/x402/reputation/demo-agent devuelve HTTP 402 con Payment-Required / X-Payment-Required, quote_id, maxAmountRequired=1000, network=base y payTo.
  • La respuesta también incluye alternativas gratuitas: verificación de política de capacidad de pago, verificador de disponibilidad, sandbox, endpoint MCP, documentación y ruta de mini-verificación.
  • Una llamada de pago debe ocurrir solo después de que la política del agente permita la liquidación USDC-en-Base y el llamante pueda almacenar la cotización/respuesta de pago para auditoría.

Propósito del Listado

Este paquete existe para respaldar la revisión de directorios de agentes/herramientas. No es una implementación de producción separada, no es un recaudador de pagos y no es una garantía legal o financiera. Ontario proporciona señales observables de disponibilidad; los agentes aún deben hacer cumplir sus propios controles de presupuesto, billetera, tiempo de espera y política antes del pago.

Ruta de Propietario Primero-Gratis

Si usted opera un endpoint MCP o x402 y encontró Ontario a través de un directorio, comience aquí antes de cualquier acción de pago:

La ruta de pago list-service es solo para propietarios que desean un listado público en el catálogo de Ontario después de que las verificaciones gratuitas sean útiles.

Si Encuentra POST /api/x402/list-service

Sondas públicas recientes están llegando directamente al endpoint de listado de pago. Trate el primer HTTP 402 como descubrimiento de precios, no como una razón para firmar de inmediato:

  1. Valide la carga útil del listado sin pago:
    • POST https://ontarioprotocol.com/api/x402/list-service/validate
  2. Ensaye el flujo de pago sin gasto en vivo:
    • POST https://ontarioprotocol.com/sandbox/api/x402/list-service
  3. Abra un problema gratuito de verificación de idoneidad si desea que el listado sea revisado antes de pagar:
  4. Use la ruta de pago solo después de que el endpoint esté listo y la política de su agente/operador permita el pago 0.50 USDC en Base:
    • POST https://ontarioprotocol.com/api/x402/list-service

Esto mantiene a los rastreadores, operadores de agentes y propietarios de endpoints en la ruta sin gasto hasta que el listado esté lo suficientemente listo para justificar un envío de catálogo de pago.

Verificación

Los rastreadores de directorios deben inspeccionar el manifiesto MCP en vivo en lugar de tratar este repositorio como la implementación del servidor:

curl -fsSL https://ontarioprotocol.com/.well-known/mcp.json
curl -fsSL https://ontarioprotocol.com/.well-known/x402.json
curl -fsSL https://ontarioprotocol.com/api/demand/stats

El endpoint MCP remoto acepta POST /mcp para llamadas JSON-RPC MCP. GET /mcp devuelve HTTP 405 con una pista de método JSON, URL del manifiesto y encabezados de descubrimiento Link; los rastreadores deben obtener /.well-known/mcp.json para el manifiesto antes de publicar JSON-RPC.

Para una secuencia de ingesta completa, consulte Guía del Rastreador de Directorios.

Para objetivos de envío clasificados y revisados por propietarios y criterios de evidencia, consulte Lista Corta de Objetivos de Directorio.

Para la compatibilidad observada con rastreadores MCP externos, consulte Recibo de Compatibilidad de Rastreadores.

Para evidencia pública de listados aceptados en agent-tools.cloud, consulte Evidencia de Listado en agent-tools.cloud.

Contrato de Evidencia

Una señal de mercado real para esta prueba de distribución debe ser una de: listado aceptado, rechazo de listado, clic en directorio, obtención por rastreador/registro, intento de listado entrante, registro, llamada x402 de pago o pago. Borradores e informes locales no cuentan.

Límite

Este repositorio contiene solo metadatos de listado público. No contiene código fuente privado, secretos, billeteras, credenciales de implementación o claves de pago.