MCPgee
MCPgee
MCPgeeMCPgee

BMAD

v1.0.0•APIs•stable

MCP server for bmad

bmadmcpai-integration
Share:
67
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is BMAD?

BMAD is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for bmad

MCP server for bmad

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server for bmad

Use Cases

Bmad API integration
mkellerman

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 6, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx bmad

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use BMAD

The BMAD MCP server brings the B.M.A.D. (Break it down, Make it real, Architect it, Deliver it) software development methodology into any AI coding assistant via the Model Context Protocol. It exposes 11 specialized AI agents covering roles like Business Analyst, Architect, Developer, UX Designer, and Debug Specialist, along with 36+ automated workflows for tasks like PRD generation, architecture design, and acceptance testing — all accessible through a single 'bmad' tool without copying methodology prompts between projects.

Prerequisites

  • Node.js 18+ and npm (for npx-based installation)
  • An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
  • Optional: a custom BMAD configuration directory if you want to override default agents or workflows
1

Add the BMAD MCP server to your client configuration

The simplest installation method is via npx, which downloads and runs the latest version automatically. Add the following block to your MCP client config file.

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

Optionally set a custom BMAD root directory

If you want to customize agents and workflows for your organization, create a bmad/ directory in your project or ~/.bmad/ globally and set the BMAD_ROOT environment variable. The server searches project-local → user-global → package defaults.

{
  "mcpServers": {
    "bmad": {
      "command": "npx",
      "args": ["-y", "bmad-mcp-server"],
      "env": {
        "BMAD_ROOT": "/path/to/your/custom-bmad"
      }
    }
  }
}
3

Use a Git remote for shared team BMAD configuration

Teams can share a centralized BMAD configuration by pointing the server at a Git repository. The server clones and uses the content from the specified branch.

{
  "mcpServers": {
    "bmad": {
      "command": "npx",
      "args": ["-y", "bmad-mcp-server", "git+https://github.com/your-org/bmad-config.git#main"]
    }
  }
}
4

Restart your MCP client and discover available agents

After adding the configuration, restart your MCP client. Ask the assistant to list available BMAD agents and workflows to confirm the server is connected and responding.

5

Invoke agents and workflows through natural language

Use the unified 'bmad' tool by asking your AI assistant to run specific agents by name or start named workflows. Agents can be given context from your current codebase or documents.

BMAD Examples

Client configuration

Claude Desktop config using npx to run bmad-mcp-server with the default package bundled methodology.

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

Prompts to try

Example prompts for invoking BMAD agents and workflows through your AI assistant.

- "Ask Mary (the Business Analyst) to analyze the market opportunity for a SaaS invoicing product"
- "Start a PRD workflow for a task management mobile app"
- "Ask the Architect agent to design the system architecture for a real-time chat service"
- "Ask Diana to debug this Python script" (attach the script)
- "Start a party-mode brainstorming session with the full planning team"
- "Run the acceptance testing workflow on the current feature"

Troubleshooting BMAD

npx takes a long time to start or times out

Install the package globally with 'npm install -g bmad-mcp-server' and replace the command with 'bmad-mcp-server' in your config. This avoids the npx download overhead on each connection.

Custom BMAD_ROOT directory is ignored and defaults are used

The server uses a priority order: project-local (./bmad/), user-global (~/.bmad/), Git remote, then package defaults. Ensure your custom directory is named 'bmad' and is at the project root, or set BMAD_ROOT to the exact absolute path.

Agent or workflow names return 'not found' errors

Ask the assistant to 'list all available BMAD agents and workflows' first. The available names depend on the BMAD version or custom configuration loaded. Spelling and casing must match the listed names exactly.

Frequently Asked Questions about BMAD

What is BMAD?

BMAD is a Model Context Protocol (MCP) server that mcp server for bmad It connects AI assistants to external tools and data sources through a standardized interface.

How do I install BMAD?

Follow the installation instructions on the BMAD GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with BMAD?

BMAD works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is BMAD free to use?

Yes, BMAD is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

BMAD Alternatives — Similar APIs Servers

Looking for alternatives to BMAD? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.

Kong

★ 43.4k

🦍 The API and AI Gateway

API Mega List

★ 5.4k

This GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪

Fetch

★ 5.4k

Fetch web content and convert to markdown for AI consumption

Fusio

★ 2.1k

Self-Hosted API Management for Builders

Korean Law

★ 1.8k

국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools

RuleGo

★ 1.5k

⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

APIsBrowse All Servers

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use BMAD?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides