BMAD MCP Server

Overview

The BMAD MCP Server provides AI assistants with access to 11 specialized agents and 36+ automated workflows from the BMAD (Building Modern Apps Decisively) methodology. Configure once, use everywhere across all your projects.

What is BMAD?

BMAD is a comprehensive software development methodology with specialized AI agents for different roles (Business Analyst, Architect, Developer, UX Designer, etc.) and workflows for common tasks (PRD generation, architecture design, debugging, testing).

Why MCP?

Instead of copying BMAD files to every project, the MCP server provides universal access:

• ✅ Single installation serves all projects
• ✅ Consistent methodology everywhere
• ✅ No project clutter
• ✅ Easy updates

Features

Unified Tool Architecture

Single bmad tool with intelligent operations:

// List available agents and workflows
{ operation: "list", query: "agents" }

// Read agent details (no execution)
{ operation: "read", type: "agent", agent: "analyst" }

// Execute agent with context
{ operation: "execute", agent: "analyst", message: "Help me..." }

11 Specialized Agents

36+ Automated Workflows

prd              # Product Requirements Document
architecture     # System architecture design
debug-inspect    # Comprehensive debugging
atdd             # Acceptance test generation
ux-design        # UX specifications
party-mode       # Multi-agent brainstorming
... and 30+ more

MCP Capabilities

• Tools - Unified bmad tool for all operations
• Resources - Access BMAD files via bmad:// URIs
• Prompts - Agents as native MCP prompts
• Completions - Smart autocomplete for arguments
• Multi-source - Project, user, and Git remote support

Installation

Prerequisites

• Node.js 18 or later
• An MCP-compatible client (Claude Desktop, VS Code with Copilot, Cline, etc.)

Quick Start

Option 1: npx (Recommended)

Add to your MCP client configuration:

{
  "mcpServers": {
    "bmad": {
      "command": "npx",
      "args": ["-y", "bmad-mcp-server"]
    }
  }
}

Option 2: Global Installation

npm install -g bmad-mcp-server

{
  "mcpServers": {
    "bmad": {
      "command": "bmad-mcp-server"
    }
  }
}

Option 3: Local Development

git clone https://github.com/mkellerman/bmad-mcp-server.git
cd bmad-mcp-server
npm install
npm run build

{
  "mcpServers": {
    "bmad": {
      "command": "node",
      "args": ["/absolute/path/to/bmad-mcp-server/build/index.js"]
    }
  }
}

Client-Specific Setup

{
  "mcpServers": {
    "bmad": {
      "command": "npx",
      "args": ["-y", "bmad-mcp-server"]
    }
  }
}