@crewpilot/agent-mcp

Your AI dev crew — plans, architects, builds, tests, and ships software autonomously. 68+ MCP tools and 25 domain skills for every phase of software development.

Install

npm install @crewpilot/agent-mcp

On install, CrewPilot automatically creates .github/ files in your project so the @CrewPilot agent appears in Copilot Chat's agent dropdown.

Usage

As an MCP Server (VS Code, Cursor, Claude Desktop)

Add to .vscode/mcp.json:

{
  "servers": {
    "crewpilot": {
      "command": "npx",
      "args": ["@crewpilot/agent-mcp"]
    }
  }
}

For Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "crewpilot": {
      "command": "npx",
      "args": ["@crewpilot/agent-mcp"]
    }
  }
}

CLI Commands

npx @crewpilot/agent-mcp          # Start MCP server (stdio)
npx @crewpilot/agent-mcp init     # Create .github/ files in current directory
npx @crewpilot/agent-mcp --help   # Show usage

Global Install

npm install -g @crewpilot/agent-mcp
crewpilot          # Start MCP server
crewpilot init     # Setup .github/ files

What Gets Created

On npm install (or crewpilot init), these files are created in your project:

| File | Purpose | |---|---| | .github/agents/crewpilot.md | Agent definition — enables @CrewPilot in Copilot Chat | | .github/copilot-instructions.md | Project-level Copilot instructions | | .github/crewpilot.config.json | Platform configuration (thresholds, board settings) | | .github/skills/*/SKILL.md | 19 domain skill files for on-demand skill loading |

Existing files are never overwritten.

MCP Tools (68)

| Module | Tools | Purpose | |---|---|---| | Terminal | 3 | Command execution and environment management | | Git | 6 | Branch, commit, diff, log, stage, status | | Knowledge | 9 | Persistent memory, search, semantic search, patterns | | Metrics | 3 | Code complexity, bundle size, coverage analysis | | Dispatch | 4 | Parallel execution, consensus, review workflows, subagent delegation | | Board | 14 | Task management, sprint tracking, PR integration | | Orchestrator | 14 | Worker lifecycle, planning, branching, PR creation | | Notification | 3 | Email and messaging notifications | | Artifacts | 3 | Phase-based artifact persistence for workflow communication | | Sessions | 3 | Session save/restore for resuming long-running workflows | | Work IQ | 3 | M365 integration — emails, meetings, docs, Teams (optional) | | Config | 1 | Runtime configuration management |

Skills (19)

Organized across five engineering pillars:

Strategize — Solution Design, Architecture Planner Assure — Code Quality, Review Functional, Review Standards, Threat Model, Vulnerability Scan, PR Intelligence Engineer — Feature Builder, Test-First, Root Cause Analysis Deliver — Change Management, Deploy Guard, Doc Governance Insights — Pattern Detection, Knowledge Base Automation — Autopilot Worker, Autopilot Meeting, Daily Digest

VS Code Extension

For a richer experience with auto-start, agent switching, and automatic .github/ syncing, install the CrewPilot VS Code Extension.

Work IQ — M365 Integration (Optional)

To enable M365 integration (emails, meetings, documents, Teams), add the Work IQ MCP server alongside CrewPilot in your .vscode/mcp.json:

{
  "servers": {
    "crewpilot": {
      "command": "npx",
      "args": ["@crewpilot/agent-mcp"]
    },
    "workiq": {
      "command": "npx",
      "args": ["-y", "@microsoft/workiq@latest", "mcp"]
    }
  }
}

Requires a Microsoft 365 Copilot license. Work IQ is entirely optional — all workflows gracefully degrade without it. See the full setup guide.

Requirements

• Node.js 20+

License

Proprietary — All rights reserved.