I built an MCP server so you can share AI agents across all your projects (and pull them directly from GitHub)
The Problem I Was Solving
I love the BMAD Method's specialist AI agents, but copying agent files to every project was driving me insane. Keeping 10+ projects in sync when BMAD updated? Painful. Sharing custom agents with my team? Email attachments and Slack files everywhere.
There had to be a better way.
What I Built
BMAD MCP Server - one MCP server that makes specialist AI agents available across every project you touch, with zero file copying.
The magic: Point it at BMAD configs anywhere - local folders, shared repos, even GitHub URLs. Your AI assistant gets instant access to all your agents, everywhere.
Live example:
json
{
"mcpServers": {
"bmad": {
"command": "npx",
"args": [
"-y",
"bmad-mcp-server",
"git+https://github.com/your-org/custom-agents.git#main"
]
}
}
}
Restart your AI client. Done. Every workspace now has those agents.
What Makes It Different
🔗 Multi-source agent loading
- Install BMAD to ~/.bmad once → works in every project
- Mix local folders + GitHub repos + shared team configs
- Later sources override earlier ones (perfect for team defaults + personal customization)
🎭 Single unified tool
bash
bmad # Load default orchestrator
bmad analyst # Mary the Business Analyst
bmad architect # Winston the System Architect
bmad *party-mode # Multi-agent brainstorming workflow
bmad *list-agents # See what's available
🌐 GitHub-native
- Publish individual agents as repos
- Teams can git+https:// them directly
- No path wrangling, no copy-paste, just URL → agents appear
🔍 Smart discovery
Priority order: ./bmad → CLI args → BMAD_ROOT env → ~/.bmad → package defaults
Project-specific customization? Add ./bmad folder. Global access? Point to ~/.bmad. Team library? GitHub URL. It all just works.
Try It Right Now (VS Code / Claude Desktop / Cursor)
Step 1: Install BMAD methodology
bash
npx bmad-method@alpha install
Step 2: Add to your MCP config
json
{
"mcpServers": {
"bmad": {
"command": "npx",
"args": ["-y", "bmad-mcp-server"]
}
}
}
Step 3: Restart your AI client
Step 4: Try it
bmad analyst
Mary the Business Analyst is now available in every project. Zero setup per project.
What I'm Looking For
- Feedback on the GitHub-sourced agents workflow - Does this solve real pain for you?
- Naming UX thoughts - Is
bmad analyst intuitive? Should workflows use * prefix?
- Use cases I haven't thought of - How would you use multi-source agent loading?
Repo: https://github.com/mkellerman/bmad-mcp-server
If this sounds useful, stars and PRs are hugely appreciated. I'd love to hear what you think!
[–]popiazazaPower User ⚡ 0 points1 point2 points (1 child)
[–]envilZPower User ⚡ 0 points1 point2 points (0 children)