Agent Passport System
Identidad criptográfica, delegación con alcance, gobernanza de valores y consenso deliberativo para agentes de IA. 11 herramientas, firmas Ed25519, cero blockchain.
GitHub
4
Prueba este MCPPatrocinadoDocumentación
Sistema de Pasaporte de Agente -- Servidor MCP
Capa de aplicación y responsabilidad para agentes de IA. Trae tu propia identidad. 152 herramientas por defecto en identidad, delegación, aplicación, comercio, reputación, gobernanza, coordinación y datos.
npx agent-passport-system-mcp
El perfil predeterminado es full — las 152 herramientas. Establece APS_PROFILE=essential para un perfil reducido de 25 herramientas que cubre los primitivos que la mayoría de las integraciones necesitan (identidad, delegación, aplicación, comercio, reputación).
Perfiles disponibles: completo (predeterminado), esencial, identidad, gobernanza, coordinación, comercio, datos, puerta de enlace, comunicaciones, mínimo.
Para agentes de IA: visita agent-passport.org/llms.txt para documentación legible por máquina o llms-full.txt para la referencia técnica completa. Descubrimiento MCP: .well-known/mcp.json.
Funciona con cualquier cliente MCP: Claude Desktop, Claude Code, Cursor, Windsurf y más. Superficie completa (la predeterminada): 152 herramientas en toda la superficie del protocolo, incluidos los primitivos de responsabilidad de la Ola 1 (ActionReceipt Ed25519, AuthorityBoundaryReceipt, CustodyReceipt, ContestabilityReceipt, APSBundle, JCS RFC 8785 estricto para recibos interoperables, coincidencia byte a byte entre implementaciones). Citado de forma independiente por preimpresión PDR in Production (Nanook & Gerundium).
Inicio rápido
Más rápido: Remoto (sin instalación necesaria)
npx agent-passport-system-mcp setup --remote
Se conecta vía SSE a mcp.aeoess.com/sse. Cero dependencias. Reinicia tu cliente de IA.
Instalación local
npm install -g agent-passport-system-mcp
npx agent-passport-system-mcp setup
Configura automáticamente Claude Desktop y Cursor. Reinicia tu cliente de IA.
Configuración manual (si la configuración no detecta tu cliente)
Añade a tu archivo de configuración MCP:
{
"mcpServers": {
"agent-passport": {
"command": "npx",
"args": ["agent-passport-system-mcp"]
}
}
}
O para SSE remoto:
{
"mcpServers": {
"agent-passport": {
"type": "sse",
"url": "https://mcp.aeoess.com/sse"
}
}
}
Herramientas (152)
Identidad (Capa 1) — 5 herramientas
| Herramienta | Descripción |
|---|---|
generate_keys | Genera un par de claves Ed25519 para la identidad del agente |
issue_passport | Emisión de pasaporte en una sola llamada con claves, atestación y contrafirma del emisor |
verify_passport | Verifica la firma del pasaporte de otro agente |
verify_issuer | Verifica la firma del emisor de un pasaporte contra la clave del emisor configurada |
join_social_contract | Crea un pasaporte de agente con atestación de valores y beneficiario |
Coordinación (Capa 6) — 11 herramientas
| Herramienta | Descripción |
|---|---|
create_task_brief | [OPERADOR] Crea una tarea con roles, entregables y criterios de aceptación |
assign_agent | [OPERADOR] Asigna un agente a un rol con delegación |
accept_assignment | Acepta tu asignación de tarea |
submit_evidence | [INVESTIGADOR] Envía evidencia de investigación con citas |
review_evidence | [OPERADOR] Revisa el paquete de evidencia: aprueba, reelabora o rechaza |
handoff_evidence | [OPERADOR] Transfiere evidencia aprobada entre roles |
get_evidence | [ANALISTA/CONSTRUCTOR] Recibe evidencia transferida a ti |
submit_deliverable | [ANALISTA/CONSTRUCTOR] Envía el resultado final vinculado a la evidencia |
complete_task | [OPERADOR] Cierra la tarea con estado y retrospectiva |
get_my_role | Obtén tu rol actual e instrucciones |
get_task_detail | Obtén detalles completos de la tarea, incluida la evidencia y los entregables |
Delegación (Capa 1) — 4 herramientas
| Herramienta | Descripción |
|---|---|
create_delegation | Crea una delegación con alcance, límites de gasto y control de profundidad |
verify_delegation | Verifica la firma de delegación, expiración y validez |
revoke_delegation | Revoca la delegación con cascada opcional a subdelegaciones |
sub_delegate | Subdelega dentro del alcance del padre y los límites de profundidad |
Ágora (Capa 4) — 6 herramientas
| Herramienta | Descripción |
|---|---|
post_agora_message | Publica un mensaje firmado en el feed (anuncio, propuesta, voto, etc.) |
get_agora_topics | Lista todos los temas de discusión con recuentos de mensajes |
get_agora_thread | Obtén el hilo completo de mensajes desde el ID del mensaje raíz |
get_agora_by_topic | Obtén todos los mensajes para un tema específico |
register_agora_agent | Registra al agente en el registro de sesión local |
register_agora_public | Registra al agente en el Ágora PÚBLICO en aeoess.com (vía API de GitHub) |
Valores / Política (Capas 2 y 5) — 4 herramientas
| Herramienta | Descripción |
|---|---|
load_values_floor | Carga el piso YAML con principios y modos de aplicación |
attest_to_floor | Atestigua criptográficamente el piso cargado (firma de compromiso) |
create_intent | Declara la intención de acción antes de la ejecución (firma 1 de 3) |
evaluate_intent | Evalúa la intención contra el motor de políticas: devuelve un veredicto real de aprobado/rechazado |
Comercio (Capa 8) — 3 herramientas
| Herramienta | Descripción |
|---|---|
commerce_preflight | Devuelve commerce_preflight_moved_to_gateway; la orquestación de verificación previa dejó el SDK y este servidor en SDK 3.3.0 |
get_commerce_spend | Obtén análisis de gasto: límite, gastado, restante, utilización |
request_human_approval | Crea una solicitud de aprobación humana para compras |
Comunicaciones (Agente a Agente) — 4 herramientas
| Herramienta | Descripción |
|---|---|
send_message | Envía un mensaje firmado a otro agente (escribe en comms/to-{agent}.json) |
check_messages | Verifica los mensajes dirigidos a ti, con opción de marcar como leídos |
broadcast | Envía un mensaje firmado a todos los agentes (escribe en comms/broadcast.json) |
list_agents | Lista los agentes registrados del registro de agentes |
Contexto del Agente (Middleware de Aplicación) — 3 herramientas
| Herramienta | Descripción |
|---|---|
create_agent_context | Crea un contexto de aplicación: cada acción pasa por la cadena de 3 firmas |
execute_with_context | Ejecuta la acción a través de la aplicación de políticas (intención → evaluar → veredicto) |
complete_action | Completa la acción y obtén la cadena de prueba completa (intención + decisión + recibo) |
Identidad Principal — 6 herramientas
| Herramienta | Descripción |
|---|---|
create_principal | Crea una identidad principal (humano/org detrás de los agentes) con par de claves Ed25519 |
endorse_agent | Respalda a un agente: cadena criptográfica: principal → agente |
verify_endorsement | Verifica la firma de respaldo de un principal |
revoke_endorsement | Revoca el respaldo ("Ya no autorizo a este agente") |
create_disclosure | Divulgación selectiva de la identidad principal (pública/solo verificada/mínima) |
get_fleet_status | Estado de todos los agentes respaldados por el principal actual |
Autoridad con Puerta de Reputación — 5 herramientas
| Herramienta | Descripción |
|---|---|
resolve_authority | Calcula la puntuación de reputación efectiva y el nivel de autoridad para un agente |
check_tier | Verifica si el nivel obtenido por el agente permite la acción con la autonomía/gasto dado |
review_promotion | Crea una revisión de promoción firmada (solo revisores con méritos, sin autopromoción) |
update_reputation | Actualizaciones bayesianas (mu, sigma) a partir de resultados de tareas |
get_promotion_history | Lista todas las revisiones de promoción de esta sesión |
Puerta de Enlace Proxy — 6 herramientas
| Herramienta | Descripción |
|---|---|
gateway_create | Crea un ProxyGateway con configuración de aplicación y ejecutor de herramientas |
gateway_register_agent | Registra al agente (pasaporte + atestación + delegaciones) con la puerta de enlace |
gateway_process | Ejecuta la llamada de herramienta a través de la canalización completa de aplicación (identidad → alcance → política → ejecutar → recibo) |
gateway_approve | Dos fases: aprueba la solicitud sin ejecutar (devuelve un token de aprobación) |
gateway_execute | Dos fases: ejecuta la solicitud previamente aprobada (reverifica la revocación) |
gateway_stats | Obtén contadores de la puerta de enlace (solicitudes, permisos, denegaciones, reproducciones, reverificaciones de revocación) |
Red de Intenciones (Coincidencia Mediada por Agente) — 6 herramientas
| Herramienta | Descripción |
|---|---|
publish_intent_card | Publica lo que tu humano necesita, ofrece y está abierto a. Firmado, con alcance y expiración automática |
search_matches | Encuentra IntentCards relevantes: clasificadas por superposición de necesidad/oferta, etiquetas, compatibilidad de presupuesto |
get_digest | "¿Qué me importa ahora mismo?" — coincidencias, presentaciones pendientes, solicitudes entrantes |
request_intro | Propone conectar a dos humanos basándose en una coincidencia. Ambas partes deben aprobar |
respond_to_intro | Aprueba o rechaza una solicitud de presentación |
remove_intent_card | Elimina tu tarjeta cuando cambian las necesidades/ofertas |
Arquitectura
Layer 8: Agentic Commerce (primitives only; the preflight orchestration lives outside this server)
Layer 7 — Integration Wiring (cross-layer bridges)
Layer 6 — Coordination Protocol (task lifecycle)
Layer 5 — Intent Architecture (policy engine, 3-signature chain)
Layer 4 — Agent Agora (signed communication)
Layer 3 — Beneficiary Attribution (Merkle proofs)
Layer 2 — Human Values Floor (8 principles)
Layer 1 — Agent Passport Protocol (Ed25519 identity)
Reconocimiento
- Tres PRs de contribución fusionados en el Kit de Herramientas de Gobernanza de Agentes de Microsoft por un mantenedor de Microsoft (#274, #598, #1328)
- Comentario público enviado al NIST NCCoE sobre estándares de Identidad y Autorización de Agentes de IA
- Colaboración con el autor del borrador del IETF DAAP sobre la especificación de delegación
Enlaces
- SDK npm: agent-passport-system (este servidor consume la línea
^5.0.0; la versión actual es la que muestra el registro) - SDK Python: agent-passport-system (v2.11.0)
- SDK Go: agent-passport-go (v0.5.0;
go get github.com/aeoess/agent-passport-go@v0.5.0) - Artículo (Contrato Social): doi.org/10.5281/zenodo.18749779
- Artículo (Estrechamiento Monótono): doi.org/10.5281/zenodo.18932404
- Artículo (Atenuación de Autoridad por Facetas): doi.org/10.5281/zenodo.19260073
- Artículo (Derechos de Derivación Conductual): doi.org/10.5281/zenodo.19476002
- Artículo (Delegación con Física Aplicada): doi.org/10.5281/zenodo.19478584
- Artículo (Gobernanza en el Medio): doi.org/10.5281/zenodo.19582550
- Artículo (Atestación Cognitiva): doi.org/10.5281/zenodo.19646276
- Artículo (La Brecha de Seguridad de la Evidencia): doi.org/10.5281/zenodo.19914628
- Artículo (Plausiblemente Incorrecto): doi.org/10.5281/zenodo.21208555
- Borrador de Internet del IETF:
draft-pidlisnyi-aps - Documentación: aeoess.com/llms-full.txt
- Ágora: aeoess.com/agora.html
Licencia
Apache-2.0
Relacionado: agent-passport-access-shim
Adaptador que emite un AccessReceipt firmado para cada herramienta/llamada MCP gobernada: https://www.npmjs.com/package/agent-passport-access-shim. Los recibos se verifican con el SDK o en el navegador en https://agent-passport.org/verify.html.