A2A Trust Plane

npx add-mcp 'https://trust.the825.co/mcp'

Interfaces y endpoints.

El Trust Plane expone el mismo despachador gobernado a través de cuatro interfaces: JSON-RPC y REST oficiales de A2A 1.0, MCP Streamable HTTP y una API REST directa para operadores. Una credencial de agente está limitada a un inquilino y a un conjunto de habilidades, independientemente de la interfaz a través de la cual se llame.

Descubra el agente y los servicios

La tarjeta pública del agente se sirve sin autenticación y describe las habilidades declaradas del servicio y los esquemas de seguridad. El catálogo de Agent City publica las capacidades y disponibilidad de los servicios de primera parte sin precios, credenciales ni datos de clientes. Las ofertas legibles por máquina publican precios y pasos de acceso sin otorgar una credencial ni crear un cargo. Un agente puede llevar la Revisión de Entrega de Agente de $500 a su propietario; la solicitud pública es revisada por un humano antes de cualquier trabajo o pago.

GET /.well-known/agent-card.json
GET /agent-city.json

Interfaces

A2A 1.0

JSON-RPC en /a2a/jsonrpc y HTTP+JSON en /a2a/rest. Ambos requieren un principal autenticado y comparten el mismo registro, política y ruta de evidencia que cualquier otra interfaz.

MCP

Los clientes MCP autenticados se conectan a /mcp. Las herramientas de Agent City incluyen city_catalog, city_quote y city_prepare_invocation. Una preparación es una prueba de autorización en seco. No invoca a un proveedor ni crea un cargo.

Ejecución directa

POST /v1/execute ejecuta una habilidad del despachador para el principal autenticado. GET /v1/skills enumera lo que su credencial puede llamar.

Auditoría

GET /v1/audit/verify verifica de forma independiente que el registro de eventos encadenado por digestión y de solo anexión no haya sido alterado.

Su primer resultado útil

Compare dos especificaciones de producto ficticias y observe que una promesa de entrega cambió. Esto prueba un endpoint de evidencia real sin conectar una tienda, enviar datos de clientes ni ejecutar un modelo.

1. Vista previa de la solicitud

   Requiere Node.js 20 o más reciente. Guarde el cliente de ejemplo independiente como first-proof.mjs. No se necesita instalación de paquetes ni acceso al repositorio.

   node first-proof.mjs
   

   El modo predeterminado imprime la entrada sintética y el resultado esperado. No realiza ninguna solicitud de red ni utiliza asignación de cuenta.

2. Elija su primera ejecución

   Para la ruta de autoservicio, abra Cuenta y ejecute una prueba sintética integrada. No se necesita código ni credencial separada para esa acción de cuenta. Las credenciales de cuenta estándar no otorgan evidence:run. Para ejecutar este ejemplo de comparación de documentos, primero organice una credencial evidence:run aprovisionada explícitamente con soporte. Un plan de pago por sí solo no otorga ese permiso. Proporcione la credencial aprobada como TRUST_PLANE_TOKEN a través de su entorno o administrador de secretos. Manténgala fuera de archivos fuente, capturas de pantalla y chats.

   node first-proof.mjs --run
   

   Esto envía una solicitud a https://trust.the825.co/v1/execute y puede consumir una operación gobernada de su plan. Nunca se reintenta automáticamente. Para un despliegue alternativo aprobado, agregue --origin https://your-host. Solo envíe su credencial a un despliegue en el que confíe.

3. Lea el resultado

   Una ejecución exitosa devuelve mode: executed, changed: true, el método de comparación line_lcs_v1 y resúmenes de entrada/resultado. Una vista previa no es un recibo de ejecución. Un cambio de texto no es prueba de que la entrega nocturna sea verdadera.

HTTP 401 significa verifique su credencial; 403 significa verifique el permiso; 402 significa verifique su plan; 429 significa espere y verifique los límites de velocidad. Un tiempo de espera deja el resultado sin confirmar: inspeccione el uso de la cuenta antes de decidir si ejecutar de nuevo.

Este ejemplo no establece compatibilidad de transporte A2A, recuperación de agentes ni una conexión Copyworthy en vivo. Lea la evidencia de recuperación sintética separada.

Evaluación de su propio agente

La evaluación limitada verifica una tarjeta pública de agente A2A y los controles operativos que usted declara. No ingiere repositorios, cuerpos de mensajes, credenciales ni registros de clientes. Ejecútela desde la página de evaluación con un token de prueba, o desde su cuenta iniciada en /customer.

Soporte

Envíe un correo a jovan@the825.co para preguntas de integración, cambios de plan o un compromiso de prueba de continuidad fundacional. Consulte Cómo Funciona para el flujo de trabajo completo de solicitud a recibo y el recorrido de incorporación de cuentas.