Teams MCP

Multi-agent orchestration MCP server for Claude Code. Discovers agent definitions in your project and spawns them in isolated sessions — not incrementally in your current context.

Quick Start

npx teamsmcp init    # auto-registers via `claude mcp add`
# Restart Claude Code

Or register manually:

claude mcp add teamsmcp -- npx -y teamsmcp@latest serve

What It Does

• Auto-discovers agent .md files in agents/, .agents/, .claude/agents/
• Spawns agents in isolated sessions via Claude Code's Agent tool — clean context every time
• 12 built-in AIOX agents available out of the box (dev, qa, devops, architect, etc.)
• AIOX framework integration when .aiox-core/ is detected — full authority enforcement, 100+ task aliases

Usage

Generic (any project)

teams_discover()                                    # List available agents
teams_run(agent: "reviewer", task: "review auth")   # Get prompt for isolated spawn
teams_prompt(agent: "reviewer")                     # Raw prompt only

AIOX mode (when .aiox-core/ exists)

aiox(task: "develop", story: "path/to/story.md")
aiox(task: "qa-gate", story: "path/to/story.md")
aiox(task: "push")

Agent File Format

Place .md files in agents/ (or .agents/, .claude/agents/):

---
name: reviewer
description: Code review specialist
model: sonnet
tools: [Read, Grep, Glob]
---
You are a code reviewer. Analyze code for bugs, security issues...

Frontmatter is optional. Without it, the filename becomes the agent name.

Built-in Agents (AIOX)

| Name | Persona | Domain | Model | |------|---------|--------|-------| | dev | Dex | Implementation, debugging, tests | sonnet | | qa | Quinn | Code review, QA gates, verdicts | sonnet | | devops | Gage | git push, PRs, CI/CD, releases | sonnet | | architect | Aria | System architecture, tech selection | opus | | pm | Morgan | PRDs, epics, requirements | opus | | po | Pax | Story validation, backlog | sonnet | | sm | River | Story creation | sonnet | | analyst | Atlas | Research, brainstorming | opus | | data-engineer | Dara | Schema, migrations, RLS | sonnet | | ux-design-expert | Uma | Wireframes, UI analysis | sonnet | | squad-creator | Craft | Agent squad design | sonnet | | aiox-master | Orion | Orchestration, routing | opus |

CLI Commands

teamsmcp init     # Configure Teams MCP in current project
teamsmcp serve    # Start MCP server (stdio)
teamsmcp status   # Show engine mode and stats

Prerequisites

• Node.js >= 18
• Build tools for native modules (better-sqlite3):
  • macOS: Xcode Command Line Tools
  • Linux: build-essential
  • Windows: Visual Studio Build Tools

License

MIT