How do I install Agent Blueprint?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Agent Blueprint need an API key?

The publisher lists these environment variables: AGENT_BLUEPRINT_API_KEY.

What transport does Agent Blueprint use?

Agent Blueprint runs locally over stdio.

When was Agent Blueprint last checked?

Last checked 2026-11-09. Client teams' blueprints for coding agents (token from an engagement). Free: agentblueprint.ai/mcp

Agent Blueprint MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

AGENT_BLUEPRINT_API_KEY — API token issued to client teams with an Agent Blueprint engagement

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1AGENT_BLUEPRINT_API_KEY=<secret> claude mcp add io.github.agent-blueprint-mcp-server -- npx -y agentblueprint@0.7.23

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.agent-blueprint-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "AGENT_BLUEPRINT_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.7.23
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

Go to Agent Blueprint Settings > API Tokens
Click "Create Token"
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

Tool	Description
`create_business_profile`	Create or upsert a structured business profile for an existing organization
`generate_use_cases`	Generate normalized use cases from the current business profile and readiness assessment
`generate_blueprint`	Start blueprint generation for a chosen use case and return an `auditId`
`trigger_full_pipeline`	Start the full pipeline for an existing business profile and return a `jobId`
`get_generation_status`	Poll either blueprint generation or full-pipeline generation status
`list_blueprints`	List all blueprints (summaries)
`get_blueprint`	Blueprint summary — title, agents, phases, pattern
`get_business_case`	Business case summary — ROI, pilot economics, recommendation
`get_implementation_plan`	Implementation plan summary — epics, timeline, story counts
`get_use_case`	Use case analysis for a blueprint
`get_implementation_spec`	Implementation spec metadata
`get_business_profile`	Organization business profile
`download_blueprint`	Download 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

URI	Description
`agentblueprint://blueprints`	Blueprint list (JSON)
`agentblueprint://blueprints/{id}`	Blueprint detail (Markdown)
`agentblueprint://blueprints/{id}/spec`	Implementation spec (Markdown)

Authentication

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

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

Environment Variables

Variable	Required	Default	Description
`AGENT_BLUEPRINT_API_KEY`	No	—	Your API token (alternative to `agentblueprint login`)
`AGENT_BLUEPRINT_API_URL`	No	`https://app.agentblueprint.ai`	API base URL

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Agent Blueprint?

Does Agent Blueprint need an API key?

What transport does Agent Blueprint use?

When was Agent Blueprint last checked?

Documentation

agentblueprint

CLI Quick Start

MCP Server Setup

Get an API Key

Supported Headless Workflow

Download Blueprint as Agent Skills

Available Tools

Available Resources

Authentication

Environment Variables