{ "schema_version": 1, "cli_version": "0.2.0", "command": { "name": "mcpstack", "description": "A CLI to manage, share, and switch MCP server configurations.", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": true, "arguments": [], "options": [ { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "schema", "long": "--schema", "short": null, "long_aliases": [], "short_aliases": [], "description": "Print the complete CLI interface as versioned JSON", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "version", "long": "--version", "short": "V", "long_aliases": [], "short_aliases": [], "description": "Print version", "action": "version", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [ { "name": "claude", "description": "Manage MCP servers in Claude Code user configuration", "subcommand_required": true, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [ { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [ { "name": "diff", "description": "Show a redacted diff of a stack against client configuration without writing files", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "Stack file path or HTTP(S) URL to compare, import, or use", "action": "set", "value_type": "string", "required": true, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Apply or compare permissions and tool filters; otherwise preserve the target policy", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "permissions_config", "long": "--permissions-config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this Claude Code settings file for permission rules", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [ "include_permissions" ] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "export", "description": "Export Claude Code MCP servers to a YAML stack file", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "Destination YAML stack file", "action": "set", "value_type": "string", "required": true, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "all", "long": "--all", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include every normally skipped server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "expose_secrets", "long": "--expose-secrets", "short": null, "long_aliases": [], "short_aliases": [], "description": "Preserve literal credentials in the stack", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_claude_browser", "long": "--include-claude-browser", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped Claude Browser server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_claude_in_chrome", "long": "--include-claude-in-chrome", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped claude-in-chrome server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_claude_preview", "long": "--include-claude-preview", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped Claude Preview server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_computer_use", "long": "--include-computer-use", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped computer-use server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include per-server MCP permissions and tool filters; --all does not include them", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_workspace", "long": "--include-workspace", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped workspace server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "overwrite", "long": "--overwrite", "short": null, "long_aliases": [], "short_aliases": [], "description": "Replace an existing stack file without prompting", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "permissions_config", "long": "--permissions-config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read Claude Code permission rules from this settings file", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "help", "description": "Print this message or the help of the given subcommand(s)", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [ { "name": "diff", "description": "Show a redacted diff of a stack against client configuration without writing files", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "export", "description": "Export Claude Code MCP servers to a YAML stack file", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "help", "description": "Print this message or the help of the given subcommand(s)", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "import", "description": "Approve and apply server additions and replacements", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "list", "description": "List configured MCP servers without starting them or checking connections", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "show", "description": "Show Claude Code MCP servers as a YAML stack", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "use", "description": "Switch stacks, replacing ALL MCP servers while preserving other client settings", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] } ] }, { "name": "import", "description": "Approve and apply server additions and replacements", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "Stack file path or HTTP(S) URL to compare, import, or use", "action": "set", "value_type": "string", "required": true, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "auto_approve", "long": "--auto-approve", "short": "y", "long_aliases": [], "short_aliases": [], "description": "Approve all selected server and permission changes without prompting", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "dry_run", "long": "--dry-run", "short": null, "long_aliases": [], "short_aliases": [], "description": "Summarize changes without writing files; use --non-interactive -y for unattended previews.\n\nWithout --non-interactive, missing secrets may still prompt even with -y.", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help (see a summary with '-h')", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Apply or compare permissions and tool filters; otherwise preserve the target policy", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "permissions_config", "long": "--permissions-config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this Claude Code settings file for permission rules", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [ "include_permissions" ] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "list", "description": "List configured MCP servers without starting them or checking connections", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [ { "name": "all", "long": "--all", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include every normally skipped server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_claude_browser", "long": "--include-claude-browser", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped Claude Browser server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_claude_in_chrome", "long": "--include-claude-in-chrome", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped claude-in-chrome server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_claude_preview", "long": "--include-claude-preview", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped Claude Preview server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_computer_use", "long": "--include-computer-use", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped computer-use server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_workspace", "long": "--include-workspace", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped workspace server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "show", "description": "Show Claude Code MCP servers as a YAML stack", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [ { "name": "all", "long": "--all", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include every normally skipped server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "expose_secrets", "long": "--expose-secrets", "short": null, "long_aliases": [], "short_aliases": [], "description": "Preserve literal credentials in the stack", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_claude_browser", "long": "--include-claude-browser", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped Claude Browser server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_claude_in_chrome", "long": "--include-claude-in-chrome", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped claude-in-chrome server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_claude_preview", "long": "--include-claude-preview", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped Claude Preview server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_computer_use", "long": "--include-computer-use", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped computer-use server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include per-server MCP permissions and tool filters; --all does not include them", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_workspace", "long": "--include-workspace", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped workspace server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "permissions_config", "long": "--permissions-config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read Claude Code permission rules from this settings file", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "use", "description": "Switch stacks, replacing ALL MCP servers while preserving other client settings", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "Stack file path or HTTP(S) URL to compare, import, or use", "action": "set", "value_type": "string", "required": true, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "auto_approve", "long": "--auto-approve", "short": "y", "long_aliases": [], "short_aliases": [], "description": "Approve replacing the entire server set and create a numbered backup", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "dry_run", "long": "--dry-run", "short": null, "long_aliases": [], "short_aliases": [], "description": "Summarize additions, replacements, and removals without approval prompts or writes", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Apply or compare permissions and tool filters; otherwise preserve the target policy", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "permissions_config", "long": "--permissions-config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this Claude Code settings file for permission rules", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [ "include_permissions" ] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] } ] }, { "name": "codex", "description": "Manage MCP servers in Codex configuration", "subcommand_required": true, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [ { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [ { "name": "diff", "description": "Show a redacted diff of a stack against client configuration without writing files", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "Stack file path or HTTP(S) URL to compare, import, or use", "action": "set", "value_type": "string", "required": true, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Apply or compare permissions and tool filters; otherwise preserve the target policy", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "permissions_config", "long": "--permissions-config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this Claude Code settings file for permission rules", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [ "include_permissions" ] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "export", "description": "Export Codex MCP servers to a YAML stack file", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "Destination YAML stack file", "action": "set", "value_type": "string", "required": true, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "all", "long": "--all", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include every normally skipped server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "expose_secrets", "long": "--expose-secrets", "short": null, "long_aliases": [], "short_aliases": [], "description": "Preserve literal credentials in the stack", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_computer_use", "long": "--include-computer-use", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped computer-use server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_node_repl", "long": "--include-node-repl", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped node_repl server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include per-server MCP permissions and tool filters; --all does not include them", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "overwrite", "long": "--overwrite", "short": null, "long_aliases": [], "short_aliases": [], "description": "Replace an existing stack file without prompting", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "help", "description": "Print this message or the help of the given subcommand(s)", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [ { "name": "diff", "description": "Show a redacted diff of a stack against client configuration without writing files", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "export", "description": "Export Codex MCP servers to a YAML stack file", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "help", "description": "Print this message or the help of the given subcommand(s)", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "import", "description": "Approve and apply server additions and replacements", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "list", "description": "List configured MCP servers without starting them or checking connections", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "show", "description": "Show Codex MCP servers as a YAML stack", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "use", "description": "Switch stacks, replacing ALL MCP servers while preserving other client settings", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] } ] }, { "name": "import", "description": "Approve and apply server additions and replacements", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "Stack file path or HTTP(S) URL to compare, import, or use", "action": "set", "value_type": "string", "required": true, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "auto_approve", "long": "--auto-approve", "short": "y", "long_aliases": [], "short_aliases": [], "description": "Approve all selected server and permission changes without prompting", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "dry_run", "long": "--dry-run", "short": null, "long_aliases": [], "short_aliases": [], "description": "Summarize changes without writing files; use --non-interactive -y for unattended previews.\n\nWithout --non-interactive, missing secrets may still prompt even with -y.", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help (see a summary with '-h')", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Apply or compare permissions and tool filters; otherwise preserve the target policy", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "permissions_config", "long": "--permissions-config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this Claude Code settings file for permission rules", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [ "include_permissions" ] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "list", "description": "List configured MCP servers without starting them or checking connections", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [ { "name": "all", "long": "--all", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include every normally skipped server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_computer_use", "long": "--include-computer-use", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped computer-use server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_node_repl", "long": "--include-node-repl", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped node_repl server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "show", "description": "Show Codex MCP servers as a YAML stack", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [ { "name": "all", "long": "--all", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include every normally skipped server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "expose_secrets", "long": "--expose-secrets", "short": null, "long_aliases": [], "short_aliases": [], "description": "Preserve literal credentials in the stack", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_computer_use", "long": "--include-computer-use", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped computer-use server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_node_repl", "long": "--include-node-repl", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include the otherwise skipped node_repl server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include per-server MCP permissions and tool filters; --all does not include them", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "use", "description": "Switch stacks, replacing ALL MCP servers while preserving other client settings", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "Stack file path or HTTP(S) URL to compare, import, or use", "action": "set", "value_type": "string", "required": true, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "auto_approve", "long": "--auto-approve", "short": "y", "long_aliases": [], "short_aliases": [], "description": "Approve replacing the entire server set and create a numbered backup", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this client config file instead of the default configuration", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "dry_run", "long": "--dry-run", "short": null, "long_aliases": [], "short_aliases": [], "description": "Summarize additions, replacements, and removals without approval prompts or writes", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Apply or compare permissions and tool filters; otherwise preserve the target policy", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "permissions_config", "long": "--permissions-config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Use this Claude Code settings file for permission rules", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [ "include_permissions" ] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] } ] }, { "name": "diff", "description": "Preview a stack against one harness", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "source", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "YAML stack file path or HTTP(S) URL; prompted when omitted", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read or write this client config instead of its default; requires one harness", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "harness", "long": "--harness", "short": null, "long_aliases": [], "short_aliases": [], "description": "Choose a harness without prompting", "action": "set", "value_type": "enum", "required": false, "default": [], "possible_values": [ "claude", "codex" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Compare permissions and tool filters", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "export", "description": "Export a portable YAML stack from one harness", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "Destination YAML stack file; prompted when omitted", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "all", "long": "--all", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include every normally skipped server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read or write this client config instead of its default; requires one harness", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "expose_secrets", "long": "--expose-secrets", "short": null, "long_aliases": [], "short_aliases": [], "description": "Preserve literal credentials in the stack", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "harness", "long": "--harness", "short": null, "long_aliases": [], "short_aliases": [], "description": "Choose a harness without prompting", "action": "set", "value_type": "enum", "required": false, "default": [], "possible_values": [ "claude", "codex" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include per-server MCP permissions and tool filters", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "overwrite", "long": "--overwrite", "short": null, "long_aliases": [], "short_aliases": [], "description": "Replace an existing stack file without prompting", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "help", "description": "Print this message or the help of the given subcommand(s)", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [ { "name": "claude", "description": "Manage MCP servers in Claude Code user configuration", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [ { "name": "diff", "description": "Show a redacted diff of a stack against client configuration without writing files", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "export", "description": "Export Claude Code MCP servers to a YAML stack file", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "import", "description": "Approve and apply server additions and replacements", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "list", "description": "List configured MCP servers without starting them or checking connections", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "show", "description": "Show Claude Code MCP servers as a YAML stack", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "use", "description": "Switch stacks, replacing ALL MCP servers while preserving other client settings", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] } ] }, { "name": "codex", "description": "Manage MCP servers in Codex configuration", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [ { "name": "diff", "description": "Show a redacted diff of a stack against client configuration without writing files", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "export", "description": "Export Codex MCP servers to a YAML stack file", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "import", "description": "Approve and apply server additions and replacements", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "list", "description": "List configured MCP servers without starting them or checking connections", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "show", "description": "Show Codex MCP servers as a YAML stack", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "use", "description": "Switch stacks, replacing ALL MCP servers while preserving other client settings", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] } ] }, { "name": "diff", "description": "Preview a stack against one harness", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "export", "description": "Export a portable YAML stack from one harness", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "help", "description": "Print this message or the help of the given subcommand(s)", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "import", "description": "Merge a stack into selected harnesses", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "list", "description": "List configured MCP servers in one harness", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "show", "description": "Print a portable YAML stack from one harness", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "update", "description": "Check for or install the latest stable mcpstack release from crates.io", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "use", "description": "Replace MCP servers in one harness with a stack", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] }, { "name": "validate", "description": "Validate a stack without changing configuration or resolving secrets", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [], "commands": [] } ] }, { "name": "import", "description": "Merge a stack into selected harnesses", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "source", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "YAML stack file path or HTTP(S) URL; prompted when omitted", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "auto_approve", "long": "--auto-approve", "short": "y", "long_aliases": [], "short_aliases": [], "description": "Approve all selected server and permission changes without prompting", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read or write this client config instead of its default; requires one harness", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "dry_run", "long": "--dry-run", "short": null, "long_aliases": [], "short_aliases": [], "description": "Summarize changes without writing files", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "harnesses", "long": "--harness", "short": null, "long_aliases": [], "short_aliases": [], "description": "Choose a harness without prompting; repeat for multiple harnesses", "action": "append", "value_type": "enum", "required": false, "default": [], "possible_values": [ "claude", "codex" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include permissions and tool filters", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "list", "description": "List configured MCP servers in one harness", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [ { "name": "all", "long": "--all", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include every normally skipped server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read or write this client config instead of its default; requires one harness", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "harness", "long": "--harness", "short": null, "long_aliases": [], "short_aliases": [], "description": "Choose a harness without prompting", "action": "set", "value_type": "enum", "required": false, "default": [], "possible_values": [ "claude", "codex" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "show", "description": "Print a portable YAML stack from one harness", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [ { "name": "all", "long": "--all", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include every normally skipped server", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read or write this client config instead of its default; requires one harness", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "expose_secrets", "long": "--expose-secrets", "short": null, "long_aliases": [], "short_aliases": [], "description": "Preserve literal credentials in the stack", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "harness", "long": "--harness", "short": null, "long_aliases": [], "short_aliases": [], "description": "Choose a harness without prompting", "action": "set", "value_type": "enum", "required": false, "default": [], "possible_values": [ "claude", "codex" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include per-server MCP permissions and tool filters", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "names", "long": "--server", "short": null, "long_aliases": [], "short_aliases": [], "description": "Select a server by exact name; repeat to select multiple servers", "action": "append", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "update", "description": "Check for or install the latest stable mcpstack release from crates.io", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [], "options": [ { "name": "auto_approve", "long": "--auto-approve", "short": "y", "long_aliases": [], "short_aliases": [], "description": "Approve installing the update without prompting (requires Cargo)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "check", "long": "--check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Check the registry without installing or writing an update cache", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "auto_approve" ], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "use", "description": "Replace MCP servers in one harness with a stack", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "source", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "YAML stack file path or HTTP(S) URL; prompted when omitted", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "auto_approve", "long": "--auto-approve", "short": "y", "long_aliases": [], "short_aliases": [], "description": "Approve replacing the entire server set and create a numbered backup", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "config", "long": "--config", "short": null, "long_aliases": [], "short_aliases": [], "description": "Read or write this client config instead of its default; requires one harness", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "dry_run", "long": "--dry-run", "short": null, "long_aliases": [], "short_aliases": [], "description": "Summarize additions, replacements, and removals without writing files", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "harness", "long": "--harness", "short": null, "long_aliases": [], "short_aliases": [], "description": "Choose a harness without prompting", "action": "set", "value_type": "enum", "required": false, "default": [], "possible_values": [ "claude", "codex" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "include_permissions", "long": "--include-permissions", "short": null, "long_aliases": [], "short_aliases": [], "description": "Include permissions and tool filters", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] }, { "name": "validate", "description": "Validate a stack without changing configuration or resolving secrets", "subcommand_required": false, "args_conflicts_with_subcommands": false, "schema_conflicts_with_subcommands": false, "arguments": [ { "name": "file", "long": null, "short": null, "long_aliases": [], "short_aliases": [], "description": "YAML stack file path or HTTP(S) URL", "action": "set", "value_type": "string", "required": true, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] } ], "options": [ { "name": "color", "long": "--color", "short": null, "long_aliases": [], "short_aliases": [], "description": "ANSI color mode for help, diagnostics, logs, diffs, and lists", "action": "set", "value_type": "enum", "required": false, "default": [ "auto" ], "possible_values": [ "auto", "always", "never" ], "min_values": 1, "max_values": 1, "conflicts_with": [], "requires": [] }, { "name": "help", "long": "--help", "short": "h", "long_aliases": [], "short_aliases": [], "description": "Print help", "action": "help", "value_type": "boolean", "required": false, "default": [], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "log", "long": "--log", "short": null, "long_aliases": [], "short_aliases": [], "description": "Override the tracing filter (also read from RUST_LOG)", "action": "set", "value_type": "string", "required": false, "default": [], "possible_values": [], "min_values": 1, "max_values": 1, "conflicts_with": [ "quiet", "verbose" ], "requires": [] }, { "name": "no_color", "long": "--no-color", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable ANSI colors; also honors nonempty NO_COLOR", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "non_interactive", "long": "--non-interactive", "short": null, "long_aliases": [], "short_aliases": [], "description": "Disable interactive prompts", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "quiet", "long": "--quiet", "short": "q", "long_aliases": [], "short_aliases": [], "description": "Limit application logs to warnings and errors", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [ "verbose" ], "requires": [] }, { "name": "skip_version_check", "long": "--skip-version-check", "short": null, "long_aliases": [], "short_aliases": [], "description": "Skip automatic update checks (explicit update commands still work)", "action": "set_true", "value_type": "boolean", "required": false, "default": [ false ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] }, { "name": "verbose", "long": "--verbose", "short": "v", "long_aliases": [], "short_aliases": [], "description": "Increase logging verbosity (-v for debug, -vv for trace)", "action": "count", "value_type": "integer", "required": false, "default": [ 0 ], "possible_values": [], "min_values": 0, "max_values": 0, "conflicts_with": [], "requires": [] } ], "commands": [] } ] }, "examples": [ "mcpstack --schema", "mcpstack --help", "mcpstack import --help", "mcpstack validate --help", "mcpstack codex --help", "mcpstack codex list --help", "mcpstack codex use --help", "mcpstack codex use work.yml --dry-run", "mcpstack codex show --help", "mcpstack codex export --help", "mcpstack codex import --help", "mcpstack codex diff --help", "mcpstack claude --help", "mcpstack claude list --help", "mcpstack claude show --help", "mcpstack claude export --help" ], "exit_statuses": [ { "status": 0, "description": "Success, help, or version", "error_code": null }, { "status": 1, "description": "Unable to write CLI output.", "error_code": "OUTPUT_ERROR" }, { "status": 2, "description": "Invalid CLI arguments. Run mcpstack --help for usage.", "error_code": "INVALID_ARGUMENT" }, { "status": 3, "description": "Unable to read the stack source. Check its file path or URL, availability, response size, and UTF-8 encoding.", "error_code": "STACK_READ_ERROR" }, { "status": 4, "description": "Invalid stack. Check the schema format.", "error_code": "INVALID_STACK" }, { "status": 5, "description": "Unable to read the client configuration. Check its path and permissions.", "error_code": "CONFIG_READ_ERROR" }, { "status": 6, "description": "Unable to export client configuration.", "error_code": "EXPORT_ERROR" }, { "status": 9, "description": "Unable to initialize logging. Check the log filter.", "error_code": "LOGGING_ERROR" }, { "status": 10, "description": "Unable to prepare stack definitions for import.", "error_code": "IMPORT_ERROR" }, { "status": 11, "description": "Unable to create a configuration backup.", "error_code": "BACKUP_ERROR" }, { "status": 13, "description": "Unable to safely write client configuration.", "error_code": "CONFIG_WRITE_ERROR" }, { "status": 14, "description": "Unable to write the exported stack file. Check its path and permissions.", "error_code": "STACK_WRITE_ERROR" }, { "status": 15, "description": "Unable to check for updates. Check your network connection and try mcpstack update --check again.", "error_code": "UPDATE_CHECK_ERROR" }, { "status": 16, "description": "Unable to update mcpstack. Check Cargo, the Rust toolchain, and installation permissions.", "error_code": "UPDATE_ERROR" } ] }