MCP Server

Model Context Protocol integration

MCP Server (Model Context Protocol)

AIWG includes an MCP server for programmatic integration with AI tools.

Quick Start

# Start MCP server (stdio transport)
aiwg mcp serve

# Install config for Claude Desktop
aiwg mcp install claude

# Install config for Cursor
aiwg mcp install cursor

# View MCP info
aiwg mcp info

Available Tools

Tool	Description
`discover`	Search AIWG skills, agents, commands, rules, flows, templates, and behaviors
`skill-list` / `skill-show`	List skills and fetch full SKILL.md bodies
`command-list` / `command-show`	List CLI commands and fetch command definitions
`rule-list` / `rule-show`	List rules and fetch rule bodies
`agent-list` / `agent-show`	List agents and fetch agent definitions
`template-list` / `template-show` / `template-render`	List, fetch, and render templates
`command-run`	Run allow-listed `aiwg` CLI commands
`artifact-read`	Read artifacts from .aiwg/ directory
`artifact-write`	Write artifacts to .aiwg/ directory

Opt-in toolsets add Flow, Mission, memory, knowledge-base, research, activity-log, index, Ralph, Mission Control, and ops tools:

aiwg mcp serve --toolsets=flows,missions
aiwg mcp serve --toolsets=all

`workflow-run` has been removed from the core MCP surface. Use `command-run` for general CLI execution, the `flows` toolset for `flow-list` / `flow-show` / `flow-run`, or the `missions` toolset for Mission guide, dispatch, and status.

Available Prompts

Prompt	Description
`decompose-task`	Break down complex tasks into steps
`parallel-execution`	Plan parallel agent workflows
`recovery-protocol`	Handle workflow failures

These prompts are auto-integrated and available in compatible tools.

Configuration

Claude Desktop

After running `aiwg mcp install claude`, the config is placed in:

macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
Linux: `~/.config/Claude/claude_desktop_config.json`

Cursor

After running `aiwg mcp install cursor`, the config is added to your Cursor settings.

Manual Configuration

If automatic installation doesn't work, add this to your MCP config:

{
  "mcpServers": {
    "aiwg": {
      "command": "aiwg",
      "args": ["mcp", "serve"]
    }
  }
}

Technical Details

Transport: stdio (standard input/output)
Protocol Version: MCP 2025-11-25
Implementation: TypeScript with @modelcontextprotocol/sdk