AgentKit
ReferenceCLI commands
BetaYou are reading docs for the beta channel (2.4.1-beta.1) — updated automatically on every beta release.Switch to stable →

CLI commands

ak mcp

Inspect local MCP server configuration

Reads Claude-style MCP server config from user settings, user .mcp.json, and project .mcp.json. Env values are redacted at parse time.

Who it's for: Power devs, AI agents, CI jobs, and desktop reviewers that need MCP inventory from CLI.

When to use it: Use before editing MCP config or validating cross-adapter MCP parity.

What changes on disk: Read-only. Reads ~/.claude/settings.json, ~/.claude/.mcp.json, and ./.mcp.json.

Examples

ak mcp list --json
ak mcp show memory --json
AGENTKIT_CLAUDE_HOME=/tmp/claude ak mcp list --cwd /tmp/project --json

Flags

FlagDescription
--claude-home stringClaude home override; defaults to AGENTKIT_CLAUDE_HOME or ~/.claude
--cwd stringProject directory override; defaults to current working directory
-h, --helphelp for mcp
--jsonEmit machine-readable JSON (implies --no-interactive)
--no-interactiveDisable interactive prompts (CI-safe)
-q, --quietSuppress non-error output on stderr
-V, --verboseExtra diagnostic output on stderr (loses to --quiet)
-y, --yesAssume yes for all prompts

Output modes

ModeBehavior
prettydefault on TTY (colors, ASCII markers)
plainauto when stdout piped or --no-interactive
json--json (single-object envelope, NDJSON-safe)

Exit codes

CodeMeaning
0success
1runtime error
2invalid flags
3user-cancel (SIGINT, prompt-cancel)

On this page