servers / bmad-mcp-server
bmad-mcp-server
communityunknownpythonread onlyhealthy
MCP server providing BMad Master orchestration with embedded agent personas, workflows, and task execution capabilities
01Tools · 7
How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.
| Tool | Risk | Side effects | Approval |
|---|---|---|---|
| bmad_file
Load embedded BMAD files on-demand (configs, agents, workflows, tasks, etc.).
Use this tool to retrieve the content of files from the embedded BMAD resources.
All files are relative to the embedded directory. Common paths:
- Config: core/config.yaml
- Agents: core/agents/bmad-master.md, bmm/agents/analyst.md
- Workflows: core/workflows/party-mode/workflow.yaml
- Workflow instructions: core/workflows/party-mode/instructions.md
- Tasks: core/tasks/workflow.xml
Note: _cfg/ manifest files are excluded - use bmad_manifest() instead.
Args:
path: Relative path within the embedded directory (e.g., "core/config.yaml")
Returns:
Content of the requested file, or an error message if the file doesn't exist
| read | false | unknown |
| bmad_task
Load a BMad task definition.
If no name provided, lists all available tasks from the manifest.
Otherwise loads the specified task file.
Args:
name: Task name or path (or None to list all)
Returns:
Task content or list of available tasks
| read | false | unknown |
| bmad_workflow
Load a BMad workflow definition.
If no name provided, lists all available workflows from the manifest.
Otherwise loads the specified workflow YAML configuration.
Common workflows:
- party-mode (Multi-agent group discussion)
- brainstorming (Brainstorming sessions)
- bmad-init (Initialize BMad in workspace)
Args:
name: Workflow name or path (or None to list all)
Returns:
Workflow YAML content or list of available workflows
| read | false | unknown |
| bmad
Main BMad interface with smart command parsing.
Intelligently routes commands to appropriate handlers:
- Agent names → loads agent (analyst, architect, dev, pm, sm, tea, ux-expert)
- Workflow names → loads workflow (party-mode, brainstorming, etc.)
- Commands → executes (list-workflows, list-tasks, list-agents)
- Default → loads master agent
Examples:
bmad() → Load master agent
bmad("analyst") → Load analyst agent
bmad("party-mode") → Load party-mode workflow
bmad("list-workflows") → List all workflows
bmad("brainstorming") → Load brainstorming workflow
Args:
command: Agent name, workflow name, or command (default: "master")
user_name: Your name for personalized interactions
language: Preferred communication language
Returns:
JSON response with instructions and files, or command result
| read | false | unknown |
| bmad_agent
Load a BMad agent persona.
If no name provided, lists all available agents from the manifest.
Otherwise loads the specified agent with injected user preferences.
Available agents (when manifest is loaded):
- master / bmad-master (Master orchestrator)
- analyst (Business Analyst)
- architect (System Architect)
- dev (Developer)
- pm (Product Manager)
- sm (Scrum Master)
- tea (Test Architect)
- ux-expert (UX Expert)
Args:
name: Agent name from manifest (or None to list all)
user_name: Your name for personalized interactions
language: Preferred communication language
Returns:
JSON with agent instructions and available files, or list of agents
| read | false | unknown |
| bmad_manifest
Load BMad manifest files from the current workspace or embedded resources.
Manifests list available resources. First attempts to load from workspace,
falls back to embedded manifests.
Args:
type: Type of manifest to load (agent, workflow, task, file)
Returns:
Manifest content in CSV format or error message
| read | false | unknown |
| bmad_config
Load BMad configuration files.
If no path provided, returns the main config file (core/config.yaml).
Specify a path to load a different config file.
Available configs:
- core/config.yaml (main configuration)
- bmm/config.yaml (BMM module configuration)
Args:
path: Optional path to specific config file
Returns:
Configuration file content in YAML format
| read | false | unknown |
02Install & source
uvx bmad-mcp-server
uvxpip install bmad-mcp-server
pip- repohttps://github.com/mkellerman/bmad-mcp-server
- packagehttps://pypi.org/project/bmad-mcp-server
- homepagehttps://github.com/mkellerman/bmad-mcp-server
- adoption67 stars · 18 forks
05Provenance & freshness
sourcesPyPI [p4]
last_checked2026-08-16 20:04Z
next_check2026-08-16 23:04Z
cadenceevery 3h
verifiedhandshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed
index_statusindex — 7 unique facts >= 5
06Badge
Add the “as seen on MCPExplorer” badge to your README.
[](https://mcpexplorer.com/servers/bmad-mcp-server)
Next step
This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.
Explore loadouts →