agentblueprint

CLI y servidor MCP para Agent Blueprint: proporciona a tu agente de codificación acceso de lectura a tus planos de IA, casos de negocio, planes de implementación y especificaciones.

Inicio rápido con CLI

# Install globally
npm install -g agentblueprint

# Store your API token (one-time)
agentblueprint login

# List blueprints
agentblueprint list

# Get a blueprint summary (JSON to stdout)
agentblueprint get blueprint <id>

# Get other artifacts
agentblueprint get business-case <id>
agentblueprint get use-case <id>
agentblueprint get implementation-plan <id>
agentblueprint get implementation-spec <id>
agentblueprint get business-profile

# Download as Agent Skills directory
agentblueprint download <id>

# Partner cross-org access
agentblueprint list --org <customer-org-id>
agentblueprint get blueprint <id> --org <customer-org-id>

O ejecútalo sin instalar mediante npx:

npx agentblueprint list --token <your-api-key>
npx agentblueprint get blueprint <id> --token <your-api-key>

Configuración del servidor MCP

El mismo binario detecta automáticamente el modo MCP cuando se canaliza stdin (no interactivo). No se necesita ningún comando adicional.

Añádelo a tu configuración MCP de Claude Code (.claude/settings.json o configuración del proyecto):

{
  "mcpServers": {
    "agent-blueprint": {
      "command": "npx",
      "args": ["@agentblueprint/mcp-server"],
      "env": {
        "AGENT_BLUEPRINT_API_KEY": "<your-api-key>"
      }
    }
  }
}

También puedes iniciar el servidor MCP explícitamente con agentblueprint serve.

Obtener una clave API

Ve a Agent Blueprint Settings > API Tokens
Haz clic en "Create Token"
Copia el token (se muestra una sola vez)

Descargar plano como Agent Skills

Descarga un plano como un directorio local de Agent Skills que cualquier agente de codificación pueda leer desde el sistema de archivos. Esta es la forma recomendada de trabajar con planos.

# Using the CLI (after `agentblueprint login`)
agentblueprint download <id>
agentblueprint download <id> --dir ./my-skills

# Or via npx
npx agentblueprint download --token <key> --blueprint <id>

Esto crea una estructura de directorio de Agent Skills:

.agent-blueprint/<blueprint-slug>/
├── SKILL.md                              # Overview + frontmatter (auto-discovered by agents)
├── references/
│   ├── business-context.md               # Use case, pain points, transformation story
│   ├── agent-specifications.md           # Full agent specs with tools, guardrails, metrics
│   ├── financial-case.md                 # ROI, cost breakdown, sensitivity, 5-year projection
│   ├── implementation-roadmap.md         # Epics, stories, timeline, roles, dependencies
│   ├── architecture-decisions.md         # Platform, pattern, integration gaps, feasibility
│   └── guardrails-and-governance.md      # Risks, mitigation, per-agent guardrails
└── scripts/
    └── validate-spec.sh                  # Structure completeness checker

El estándar Agent Skills es compatible con Claude Code, Codex, Cursor, GitHub Copilot, Windsurf y más de 18 agentes de codificación. SKILL.md se carga automáticamente al activarse (~100 tokens), los archivos de referencia se cargan bajo demanda.

Herramientas disponibles

Herramienta	Descripción
`list_blueprints`	Listar todos los planos (resúmenes)
`get_blueprint`	Resumen del plano: título, agentes, fases, patrón
`get_business_case`	Resumen del caso de negocio: ROI, economía piloto, recomendación
`get_implementation_plan`	Resumen del plan de implementación: épicas, cronograma, recuento de historias
`get_use_case`	Análisis de caso de uso para un plano
`get_implementation_spec`	Metadatos de la especificación de implementación
`get_business_profile`	Perfil de negocio de la organización
`download_blueprint`	Descargar plano completo como manifiesto de archivo de Agent Skills

Las herramientas get_blueprint, get_business_case y get_implementation_plan devuelven resúmenes concisos optimizados para las ventanas de contexto del agente. Para obtener detalles completos (especificaciones del agente, proyecciones financieras, historias de usuario), utiliza download_blueprint para obtener el directorio completo de Agent Skills.

Recursos disponibles

URI	Descripción
`agentblueprint://blueprints`	Lista de planos (JSON)
`agentblueprint://blueprints/{id}`	Detalle del plano (Markdown)
`agentblueprint://blueprints/{id}/spec`	Especificación de implementación (Markdown)

Autenticación

Tres formas de proporcionar tu token de API (se verifican en este orden):

Flag --token <key> en cualquier comando
Variable de entorno AGENT_BLUEPRINT_API_KEY
agentblueprint login (guardado en ~/.config/agentblueprint/config.json)

Variables de entorno

Variable	Requerido	Predeterminado	Descripción
`AGENT_BLUEPRINT_API_KEY`	No	—	Tu token de API (alternativa a `agentblueprint login`)
`AGENT_BLUEPRINT_API_URL`	No	`https://app.agentblueprint.ai`	URL base de la API

Agent Blueprint

agentblueprint

Inicio rápido con CLI

Configuración del servidor MCP

Obtener una clave API

Descargar plano como Agent Skills

Herramientas disponibles

Recursos disponibles

Autenticación

Variables de entorno

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API