Skip to main content
Glama

BMAD MCP Server

by Dali1789
GitHub
Python
MIT License
2
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

BMAD MCP Server 🚀

MCP Compatible Python 3.8+ License: MIT

A comprehensive Model Context Protocol (MCP) server implementing the BMAD (Business Modeling and Development) methodology. Provides intelligent task management, multi-agent workflows, and cross-IDE project management through the MCP protocol.

✨ Features

🤖 6 Specialized AI Agents

  • 📊 Analyst: Business analysis, market research, requirement gathering

  • 🏗️ Architect: System design, architecture planning, tech stack selection

  • 💻 Developer: Code implementation, debugging, technical development

  • 📋 Project Manager: Task coordination, timeline management, resource planning

  • 🔍 QA: Quality assurance, testing strategies, code review

  • 🔍 Coder Agent: Advanced semantic code analysis and editing capabilities ⭐ NEW!

📋 Advanced Task Management

  • Real-time Progress Tracking: Live updates and notifications

  • Intelligent Scheduling: Auto-allocation with capacity management

  • Follow-up Task Generation: Automatic workflow progression

  • Notion Integration: Bi-directional sync with Notion databases

  • TodoWrite Bridge: Seamless Claude integration

⏱️ Time & Cost Tracking ⭐ NEW!

  • Precise Time Tracking: Exact time spent on each project with session management

  • AI Cost Calculation: Automatic calculation of AI model costs per project

  • Project Billing: Comprehensive billing reports for client invoicing

  • Multi-format Export: JSON, CSV, and invoice-style billing reports

  • Cost Optimization: Track and optimize AI model usage across projects

  • Session Management: Auto-end stale sessions and track work patterns

🎨 Template-System & Standardisierte Projektstrukturen ⭐ NEW!

  • 6 Projekt-Templates: standard, web-app, api, mobile, data-science, infrastructure

  • Automatische Struktur-Erstellung: Einheitliche .bmad-core/ Verzeichnisse

  • Auto-Discovery: Erkennt automatisch neue BMAD-Projekte

  • Migration-Tools: Migriert bestehende Projekte auf BMAD v2.0 Standard

  • Zero-Setup: Neue Projekte sind sofort produktiv mit kompletter Konfiguration

🔄 Enhanced Features

  • BMAD-METHOD Workflow System: Complete implementation with intelligent orchestration ⭐ NEW!

  • Quality Gates (@qa commands): 6 comprehensive quality assurance commands ⭐ NEW!

  • Advanced Semantic Code Analysis: Professional code intelligence via Coder Agent ⭐ NEW!

  • Time-based Monitoring: Scheduled reminders and progress checks

  • Work Day Simulation: Demo modes and realistic progression testing

  • Live Console Output: Beautiful formatted status displays

  • Project Context Integration: Multi-project support with global registry

  • Performance Metrics: Detailed tracking and reporting

🌐 Universal IDE Access

Compatible with any IDE supporting MCP:

  • Claude Code ✅

  • VS Code ✅

  • Cursor ✅

  • Any MCP-compatible IDE ✅

🚀 Quick Start

Prerequisites

  • Python 3.8+

  • OpenRouter API Key (for AI model routing)

  • Notion API Token (optional, for database sync)

Installation

# 1. Clone the repository git clone https://github.com/yourusername/bmad-mcp-server.git cd bmad-mcp-server # 2. Install dependencies pip install -r requirements.txt # 3. Set up environment variables cp .env.example .env # Edit .env with your API keys

Configuration

Add to your IDE's MCP configuration:

Claude Code (claude_desktop_config.json)

{ "mcpServers": { "bmad": { "command": "python", "args": ["-m", "src.bmad_mcp.server"], "cwd": "/path/to/bmad-mcp-server", "env": { "PYTHONPATH": "/path/to/bmad-mcp-server", "OPENROUTER_API_KEY": "your_openrouter_api_key", "NOTION_TOKEN": "your_notion_token" } } } }

VS Code / Cursor

{ "mcp.servers": { "bmad": { "command": "python", "args": ["-m", "src.bmad_mcp.server"], "cwd": "/path/to/bmad-mcp-server", "env": { "PYTHONPATH": "/path/to/bmad-mcp-server", "OPENROUTER_API_KEY": "your_openrouter_api_key" } } } }

🛠️ Available MCP Tools

🤖 Agent Management

Tool

Description

Example

bmad_list_agents

List all available agents

Shows 5 specialized agents

bmad_activate_agent

Switch to specific agent

agent: "dev"

bmad_get_agent_help

Get agent-specific guidance

Context-aware help

📋 Task Management

Tool

Description

Example

bmad_get_task_summary

Comprehensive task overview

Progress, metrics, status

bmad_create_task

Create new task with auto-scheduling

task_id

,

name

,

hours

bmad_update_task_progress

Update progress with real-time sync

task_id

,

hours_completed

bmad_get_today_tasks

Today's scheduled tasks

Daily workload view

bmad_get_agent_tasks

Agent-specific task list

Filter by agent

⏱️ Time & Cost Tracking ⭐ NEW!

Tool

Description

Example

bmad_start_timer

Start time tracking for a task

task_id

,

agent

,

session_type

bmad_stop_timer

Stop timer and calculate costs

task_id

,

ai_model

,

tokens

bmad_get_active_timers

List all currently running timers

Active sessions overview

bmad_get_task_time_summary

Time tracking summary for task

Hours, cost, sessions

bmad_get_daily_time_report

Daily time tracking report

Project breakdown, hours

bmad_get_project_billing

Generate project billing report

JSON, CSV, invoice formats

bmad_auto_end_stale_sessions

End sessions running too long

Cleanup stale timers

bmad_update_model_costs

Update AI model pricing

Configure cost per token

bmad_get_model_costs

Get current model costs

View pricing configuration

⚡ Enhanced Features

Tool

Description

Example

bmad_start_realtime_mode

Enable live task monitoring

Background updates

bmad_start_work_session

Track work session for task

Time tracking

bmad_simulate_work_day

Demo realistic work progression

Testing & demos

bmad_get_project_status

Comprehensive project overview

Multi-project support

bmad_sync_notion_tasks

Sync with Notion databases

Bi-directional sync

🔧 Project Management

Tool

Description

Example

bmad_detect_project

Scan for BMAD configuration

Auto-discovery

bmad_register_project

Add project to global registry

Cross-IDE access

bmad_execute_task

Run BMAD methodology tasks

Template-based execution

bmad_create_document

Generate documents from templates

Automated documentation

bmad_run_checklist

Quality assurance checklists

QA workflows

🚀 BMAD-METHOD Workflow System ⭐ NEW!

Tool

Description

Example

bmad_workflow_start_project

Start BMAD-METHOD project workflow

Full/planning/development modes

bmad_workflow_advance

Advance workflow to next state

Project/story state transitions

bmad_workflow_start_story

Create story in development cycle

Story creation & planning

bmad_workflow_run_qa

Execute quality gate (@qa commands)

*risk, *design, *trace, *nfr, *review, *gate

bmad_workflow_execute_command

Route agent commands intelligently

Context-aware agent routing

bmad_workflow_get_status

Get comprehensive workflow status

Real-time progress monitoring

bmad_workflow_generate_report

Generate detailed workflow reports

Analytics & recommendations

🔍 Semantic Code Analysis ⭐ NEW!

Tool

Description

Example

bmad_coder_activate_project

Activate project for analysis

Semantic code intelligence

bmad_coder_find_symbol

Find code symbols semantically

Functions, classes, variables

bmad_coder_get_symbols_overview

Get file symbol overview

Code structure analysis

bmad_coder_find_referencing_symbols

Find symbol references

Cross-reference tracking

bmad_coder_insert_after_symbol

Insert code after symbol

Precise code insertion

bmad_coder_replace_symbol_body

Replace symbol implementation

Code modification

bmad_coder_execute_shell_command

Execute shell commands

Testing, building, automation

bmad_coder_search_for_pattern

Advanced pattern search

Intelligent code search

bmad_coder_write_memory

Store project knowledge

Persistent insights

bmad_coder_read_memory

Load stored knowledge

Access project memories

🎨 Template-System ⭐ NEW!

Tool

Description

Example

bmad_create_project

Create project with standardized structure

path

,

template

bmad_list_project_templates

Show all available templates

6 templates available

bmad_get_project_template_info

Detailed template information

Features, structure

bmad_migrate_project_to_standard

Migrate existing project

Auto-backup, structure

📊 Usage Examples

Basic Task Management

# List available agents bmad_list_agents() # Activate developer agent bmad_activate_agent(agent="dev") # Create a new task bmad_create_task( task_id="feature-implementation", name="Implement user authentication", allocated_hours=8.0, agent="dev" ) # Update progress bmad_update_task_progress( task_id="feature-implementation", hours_completed=2.5 ) # Get daily overview bmad_get_today_tasks()

Real-time Monitoring

# Start live monitoring bmad_start_realtime_mode() # Begin work session bmad_start_work_session(task_id="feature-implementation") # Work on task... # End session with automatic progress logging bmad_end_work_session( task_id="feature-implementation", hours_worked=2.0 ) # Get comprehensive status bmad_get_realtime_status()

Time & Cost Tracking ⭐ NEW!

# Start time tracking for a task bmad_start_timer( task_id="feature-implementation", agent="dev", session_type="development", description="Implementing user authentication system" ) # Stop timer with AI cost calculation bmad_stop_timer( task_id="feature-implementation", ai_model_used="claude-sonnet-4", tokens_input=1500, tokens_output=800, mark_completed=False ) # Get task time summary bmad_get_task_time_summary(task_id="feature-implementation") # Generate project billing report bmad_get_project_billing( project_id="my-project-id", start_date="2025-01-01", end_date="2025-01-31", export_format="invoice" # json, csv, or invoice ) # Get daily tracking report bmad_get_daily_time_report(date="2025-01-20") # Auto-end stale sessions (running >8 hours) bmad_auto_end_stale_sessions(max_hours=8)

Project Context

# Detect BMAD project bmad_detect_project(path="./my-project") # Register in global registry bmad_register_project( project_path="./my-project", project_name="My Awesome Project" ) # Get project overview bmad_get_project_status()

Template-System Usage ⭐ NEW!

# List available templates bmad_list_project_templates() # Get template details bmad_get_project_template_info(template_name="web-app") # Create new project with template bmad_create_project( project_path="./my-web-app", template="web-app", name="My Web Application", description="Modern React-based web application" ) # Migrate existing project bmad_migrate_project_to_standard( project_path="./legacy-project", backup=True )

Available Templates

  • standard: Basic BMAD project with full structure

  • web-app: Frontend/Backend with React/Vue/Angular support

  • api: REST/GraphQL APIs with OpenAPI documentation

  • mobile: React Native/Flutter cross-platform apps

  • data-science: ML/Jupyter with notebooks and data pipelines

  • infrastructure: Docker/Terraform/Kubernetes deployments

Simulation & Testing

# Simulate full work day bmad_simulate_work_day(speed_factor=10.0) # Test specific agent workflow bmad_simulate_agent_workday(agent="qa", hours=6.0) # Simulate crisis scenarios bmad_simulate_crisis_scenario(crisis_type="blocked_task")

Advanced Time Tracking Workflows ⭐ NEW!

# Start comprehensive work session bmad_start_timer( task_id="user-auth-system", agent="dev", session_type="development", description="Implementing OAuth2 integration" ) # Work on task with AI assistance # ... development work with AI model usage ... # Stop timer with detailed AI cost tracking bmad_stop_timer( task_id="user-auth-system", ai_model_used="claude-sonnet-4", tokens_input=2500, tokens_output=1200, mark_completed=True ) # Generate comprehensive project billing billing_report = bmad_get_project_billing( project_id="client-project-2025", start_date="2025-01-01", end_date="2025-01-31", export_format="invoice" ) # Monitor daily productivity daily_report = bmad_get_daily_time_report("2025-01-20") print(f"Today: {daily_report['total_hours']:.2f}h, ${daily_report['total_cost_usd']:.2f}") # Automatic session management bmad_auto_end_stale_sessions(max_hours=6) # End sessions > 6 hours

🏗️ Architecture

bmad-mcp-server/ ├── src/ │ └── bmad_mcp/ │ ├── core/ # Core functionality │ │ ├── task_tracker.py # Advanced task management │ │ ├── time_cost_tracker.py # Time & cost tracking ⭐ NEW! │ │ ├── console_formatter.py # Live output formatting │ │ ├── realtime_updater.py # Real-time monitoring │ │ ├── time_monitor.py # Scheduled monitoring │ │ ├── simulator.py # Demo & testing │ │ ├── notion_sync.py # Notion integration │ │ └── global_registry.py # Cross-IDE projects │ ├── agents/ # Agent definitions │ │ ├── analyst.py # Business analysis │ │ ├── architect.py # System design │ │ ├── developer.py # Code implementation │ │ ├── project_manager.py # Project coordination │ │ ├── qa.py # Quality assurance │ │ └── coder.py # Advanced semantic code analysis and editing │ ├── workflows/ # BMAD-METHOD workflow system │ │ ├── workflow_engine.py # Central workflow orchestration │ │ ├── orchestrator_agent.py # Project/Story lifecycle management │ │ ├── quality_gates.py # Quality assurance (@qa commands) │ │ └── workflow_states.py # State machine definitions │ ├── tools/ # MCP tool implementations │ ├── routing/ # OpenRouter integration │ └── server.py # MCP server ├── config/ # Configuration templates ├── docs/ # Documentation ├── examples/ # Usage examples └── tests/ # Test suite

🔧 Configuration

Environment Variables

# Required OPENROUTER_API_KEY=your_openrouter_api_key_here # Optional NOTION_TOKEN=your_notion_integration_token BMAD_MAX_DAILY_HOURS=10 BMAD_DEFAULT_AGENT=dev BMAD_LOG_LEVEL=INFO

Agent Configuration

Each agent can be customized via configuration files:

# config/bmad-global-config.yaml agents: dev: model: "anthropic/claude-3.5-sonnet" temperature: 0.1 max_tokens: 4000 architect: model: "anthropic/claude-3-opus" temperature: 0.3 max_tokens: 8000

🐳 Docker Deployment

# Build and run with Docker Compose docker-compose up -d # Environment variables via .env file cp .env.example .env # Edit .env file with your API keys docker-compose up -d

🧪 Testing

# Run test suite python -m pytest tests/ # Run specific test category python -m pytest tests/test_task_management.py # Run with coverage python -m pytest --cov=src/bmad_mcp tests/

📚 Documentation

🤝 Contributing

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

📈 Roadmap

✅ Recently Completed (v2.1)

  • Time & Cost Tracking System: Precise project billing with AI cost calculation ⭐ NEW!

  • BMAD-METHOD Workflow System: Complete workflow implementation with intelligent orchestration

  • Quality Gates System: All 6 @qa commands (*risk, *design, *trace, *nfr, *review, *gate)

  • Serena Bridge Agent: LSP-based semantic code intelligence integration

  • Agent Coordination: 6-agent ecosystem with smart routing and collaboration

  • Template-System: 6 standardized project templates

  • Auto-Discovery: Automatic project detection and integration

  • Migration Tools: Legacy project migration to BMAD v2.0

  • Standardized Structure: Unified .bmad-core/ project layout

🔄 In Progress (v2.2)

  • Workflow Automation: Advanced automation rules and triggers

  • Multi-Project Workflows: Cross-project dependency management

  • Enhanced Analytics: Workflow performance insights and optimization

  • Custom Quality Gates: User-definable quality criteria and checks

🚀 Planned Features (v3.0)

  • Web Dashboard: Browser-based workflow management interface

  • Team Collaboration: Multi-user project support with role-based access

  • Enterprise Workflows: Advanced enterprise features and compliance

  • Serena Enhancements: Multi-language LSP support and AI-assisted refactoring

  • Plugin System: Custom agent and quality gate development

  • Mobile App: Companion mobile application for workflow monitoring

  • Template Marketplace: Community-driven template sharing platform

🔐 Security

  • All API keys managed via environment variables

  • No secrets stored in code or configuration files

  • Secure MCP protocol communication

  • Optional token rotation and audit logging

See SECURITY.md for security guidelines.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

💬 Support

🙏 Acknowledgments

Made with ❤️ for developers who love intelligent task management

Deploy Server
-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides intelligent agent routing with 5 specialized AI agents (analyst, architect, dev, pm, qa) through OpenRouter integration. Enables unified project structure across all IDEs with global registry management and automated BMAD methodology workflows.

  1. ✨ Features
    1. 🤖 6 Specialized AI Agents
    2. 📋 Advanced Task Management
    3. ⏱️ Time & Cost Tracking ⭐ NEW!
    4. 🎨 Template-System & Standardisierte Projektstrukturen ⭐ NEW!
    5. 🔄 Enhanced Features
    6. 🌐 Universal IDE Access
  2. 🚀 Quick Start
    1. Prerequisites
    2. Installation
    3. Configuration
  3. 🛠️ Available MCP Tools
    1. 🤖 Agent Management
    2. 📋 Task Management
    3. ⏱️ Time & Cost Tracking ⭐ NEW!
    4. ⚡ Enhanced Features
    5. 🔧 Project Management
    6. 🚀 BMAD-METHOD Workflow System ⭐ NEW!
    7. 🔍 Semantic Code Analysis ⭐ NEW!
    8. 🎨 Template-System ⭐ NEW!
  4. 📊 Usage Examples
    1. Basic Task Management
    2. Real-time Monitoring
    3. Time & Cost Tracking ⭐ NEW!
    4. Project Context
    5. Template-System Usage ⭐ NEW!
    6. Available Templates
    7. Simulation & Testing
    8. Advanced Time Tracking Workflows ⭐ NEW!
  5. 🏗️ Architecture
    1. 🔧 Configuration
      1. Environment Variables
      2. Agent Configuration
    2. 🐳 Docker Deployment
      1. 🧪 Testing
        1. 📚 Documentation
          1. 🤝 Contributing
            1. 📈 Roadmap
              1. ✅ Recently Completed (v2.1)
              2. 🔄 In Progress (v2.2)
              3. 🚀 Planned Features (v3.0)
            2. 🔐 Security
              1. 📝 License
                1. 💬 Support
                  1. 🙏 Acknowledgments

                    Related MCP Servers

                    • OpenRouter MCP Server

                      heltonteixeira
                      A
                      security
                      A
                      license
                      A
                      quality
                      Provides integration with OpenRouter.ai, allowing access to various AI models through a unified interface.
                      Last updated -
                      70
                      60
                      Apache 2.0

                    • MCP Architect

                      A
                      security
                      A
                      license
                      A
                      quality
                      Facilitates comprehensive architectural design and evaluation through specialized agents, rich resources, and powerful tools covering diverse architectural domains, including cloud, AI, and blockchain.

                    • MindBridge MCP Server

                      pinkpixel-dev
                      A
                      security
                      A
                      license
                      A
                      quality
                      An AI router that connects applications to multiple LLM providers (OpenAI, Anthropic, Google, DeepSeek, Ollama, etc.) with smart model orchestration capabilities, enabling dynamic switching between models for different reasoning tasks.
                      Last updated -
                      3
                      12
                      21
                      MIT License
                      • Linux
                      • Apple

                    • BMAD Agent FastMCP Service

                      2799662352
                      -
                      security
                      A
                      license
                      -
                      quality
                      A professional AI agent system that provides 10+ specialized agents and 25+ MCP tools to support development workflows in Cursor IDE, with dual LLM mode support (built-in and DeepSeek API).
                      Last updated -
                      4
                      MIT License

                    View all related MCP servers

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/Dali1789/bmad-mcp-server'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server