# axx mcp

> Serve Axx to coding agents over the Model Context Protocol (stdio)

Source: https://axx.nimbusxr.us/next/references/cli/axx-mcp/

Start an MCP server on stdin/stdout exposing tools to search and explain
steps, validate features, run scenarios, inspect failures and manage services.

Connect an agent to it with `axx mcp install --agent <agent>` (axx init does it
for the agents a repository already uses), or add it yourself, e.g. in .mcp.json:
  {"mcpServers": {"Axx": {"command": "Axx", "args": ["mcp"]}}}

```text
Usage:
  axx mcp [flags]
  axx mcp [command]

Available Commands:
  install     Add the axx MCP server to a coding agent's configuration

Flags:
  -h, --help             help for mcp
      --profile string   config profile for all tool calls

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)

Use "axx mcp [command] --help" for more information about a command.
```

## axx mcp install

Add the Axx MCP server to one agent's configuration, merged into the file the
agent reads: other servers and settings stay as they are, and a file that
already has Axx is left alone.

  agent    project scope (the default)   user scope
  claude   .mcp.json                     prints `claude mcp add --scope user ...`
  codex    .codex/config.toml            ~/.codex/config.toml ($CODEX_HOME)
  cursor   .cursor/mcp.json              ~/.cursor/mcp.json
  vscode   .vscode/mcp.json              prints `code --add-mcp ...`
  gemini   .gemini/settings.json         ~/.gemini/settings.json

Claude Code keeps its user servers with its own state, and VS Code in its
profile, so for them Axx prints the agent's own command instead. Codex loads a
project's .codex/config.toml once you trust the project. Only --scope user
writes to your home directory.

```text
Usage:
  axx mcp install [flags]

Examples:
  axx mcp install --agent claude
  axx mcp install --agent codex --scope user

Flags:
      --agent string   the agent: claude, codex, cursor, vscode, gemini
      --dry-run        show what would be written without writing
  -h, --help           help for install
      --scope string   project (this repository's files) or user (your home directory) (default "project")

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)
```