MCP Server

What agent-blueprint/mcp-server MCP server does

The agent-blueprint/mcp-server MCP server exposes Agent Blueprint workflows to MCP-compatible clients. It can create or update a structured profile for an existing organization, derive normalized use cases, start blueprint generation, and launch the full generation pipeline. It also provides read access to blueprint and organization artifacts, including business cases, implementation plans, use-case analyses, implementation specifications, and business profiles.

The server is intended for workflows that begin with an existing organization and an available API token. It does not create organizations, perform OAuth setup, or extract free-form source material into a business profile.

How it works

Generation is asynchronous. generate_blueprint returns an audit identifier, while trigger_full_pipeline returns a job identifier. Use get_generation_status to poll either process until it completes, then use the resulting blueprint identifier with download_blueprint.

The agent-blueprint/mcp-server MCP server returns concise artifact summaries for context-sensitive operations. A downloaded blueprint contains an Agent Skills directory with a SKILL.md file and reference documents covering business context, agent specifications, financial details, implementation planning, architecture decisions, and governance. The download also includes a shell script for checking structure completeness.

The output is described as vendor-agnostic and can be used with platforms such as ServiceNow, Salesforce, or OpenClaw. The generated Agent Skills directory is intended for coding agents that can read files from the local filesystem.

Setup and configuration

The repository documents installation with the agentblueprint npm package. The MCP configuration runs npx with @agentblueprint/mcp-server; the binary detects MCP mode when standard input is piped. It can also be started explicitly with agentblueprint serve.

Authentication uses an Agent Blueprint API token. The server checks AGENT_BLUEPRINT_API_KEY, while the CLI can also use a token flag or credentials saved by agentblueprint login. The API base URL defaults to https://app.agentblueprint.ai and can be overridden with AGENT_BLUEPRINT_API_URL.

Tools and capabilities

The agent-blueprint/mcp-server MCP server includes tools for:

• Creating or upserting an existing organization’s business profile.
• Generating use cases and starting either individual blueprint or full-pipeline generation.
• Polling generation status.
• Listing blueprints and retrieving blueprint, business case, use case, implementation plan, implementation specification, and business profile data.
• Downloading a complete blueprint as an Agent Skills file manifest.

It also publishes resources for a blueprint list, individual blueprint details, and implementation specifications.

Limitations and notes

Summary tools are designed to keep responses concise. Full agent specifications, financial projections, user stories, and related implementation details are available through the downloaded Agent Skills directory rather than the summary responses.

The documented headless flow assumes an existing personal access token and organization. Organization creation, OAuth bootstrap, and free-form context extraction are outside the current scope. The API token should be supplied through the environment, the CLI login flow, or a command-line token option as appropriate.