convez.ai
MCP ServerAutomaçãoIntermediário
agent-blueprint

Agent Blueprint MCP Server

agent-blueprint/mcp-server

Conecte agentes IA a blueprints e planos de implementação estruturados

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta agentes de IA com blueprints estruturados, casos de negócio e planos de implementação. Oferece 23 ferramentas para criar perfis de negócio, gerar artefatos de pipeline, explorar dados e sincronizar estado de implementação, com saída agnóstica a plataforma (ServiceNow, Salesforce, etc).

Instalação

$npx convez-ai agent-blueprint/mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 1 semana
Versão
—
Issues abertas
1
Contribuidores
2

Casos de uso

  • Gerar blueprints completos e cases de negócio programaticamente
  • Baixar especificações de agentes como diretórios locais prontos para uso
  • Sincronizar estado de implementação entre agentes IA e plataformas corporativas
  • Explorar e reutilizar artefatos de pipeline em workflows de agentes

Veredito

MCP server robusto para orquestração de blueprints empresariais com agentes IA. Bem estruturado com CLI e modo servidor integrados, suporta acesso multi-org e download de artefatos completos. Recomendado para times que precisam automatizar pipeline de design de agentes com rastreabilidade e governança.

README

A tradução para o português deste README ainda está na fila.

agentblueprint

CLI and MCP server for Agent Blueprint — 23 MCP tools for creating structured business profiles, generating pipeline artifacts, exploring blueprint data, syncing implementation state, and downloading full Agent Skills directories. Vendor-agnostic output works with ServiceNow, Salesforce, OpenClaw, or any platform.

CLI Quick Start

# 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>

Or run without installing via npx:

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

MCP Server Setup

The same binary auto-detects MCP mode when stdin is piped (non-interactive). No separate command needed.

Add to your Claude Code MCP config (.claude/settings.json or project settings):

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

You can also start the MCP server explicitly with agentblueprint serve.

Get an API Key

  1. Go to Agent Blueprint Settings > API Tokens
  2. Click "Create Token"
  3. Copy the token (shown once)

Supported Headless Workflow

Current scope is intentionally narrow:

existing PAT + existing org -> create_business_profile -> generate_use_cases -> generate_blueprint or trigger_full_pipeline -> get_generation_status -> download_blueprint

This release does not handle organization creation, OAuth bootstrap, or free-form context extraction into the business profile.

Download Blueprint as Agent Skills

Download a blueprint as a local Agent Skills directory that any coding agent can read from the filesystem. This is the recommended way to work with blueprints.

# 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>

This creates an Agent Skills directory structure:

.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

The Agent Skills standard is supported by Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, and 18+ other coding agents. SKILL.md loads automatically at activation (~100 tokens), reference files load on demand.

Available Tools

ToolDescription
create_business_profileCreate or upsert a structured business profile for an existing organization
generate_use_casesGenerate normalized use cases from the current business profile and readiness assessment
generate_blueprintStart blueprint generation for a chosen use case and return an auditId
trigger_full_pipelineStart the full pipeline for an existing business profile and return a jobId
get_generation_statusPoll either blueprint generation or full-pipeline generation status
list_blueprintsList all blueprints (summaries)
get_blueprintBlueprint summary — title, agents, phases, pattern
get_business_caseBusiness case summary — ROI, pilot economics, recommendation
get_implementation_planImplementation plan summary — epics, timeline, story counts
get_use_caseUse case analysis for a blueprint
get_implementation_specImplementation spec metadata
get_business_profileOrganization business profile
download_blueprintDownload full blueprint as Agent Skills file manifest

The generate_blueprint and trigger_full_pipeline tools are asynchronous. Use get_generation_status to poll until the run completes, then call download_blueprint with the resolved blueprintId.

The get_blueprint, get_business_case, and get_implementation_plan tools return concise summaries optimized for agent context windows. For full details (agent specs, financial projections, user stories), use download_blueprint to get the complete Agent Skills directory.

Available Resources

URIDescription
agentblueprint://blueprintsBlueprint list (JSON)
agentblueprint://blueprints/{id}Blueprint detail (Markdown)
agentblueprint://blueprints/{id}/specImplementation spec (Markdown)

Authentication

Three ways to provide your API token (checked in this order):

  1. --token <key> flag on any command
  2. AGENT_BLUEPRINT_API_KEY environment variable
  3. agentblueprint login (saved to ~/.config/agentblueprint/config.json)

Environment Variables

VariableRequiredDefaultDescription
AGENT_BLUEPRINT_API_KEYNo—Your API token (alternative to agentblueprint login)
AGENT_BLUEPRINT_API_URLNohttps://app.agentblueprint.aiAPI base URL
Ver o original no GitHub

Bom para

Relacionados