mcpjam command. For guides and recipes, see the individual command pages.
Global flags
| Flag | Default | Description |
|---|---|---|
--timeout <ms> | 30000 | Request timeout in milliseconds |
--rpc | off | Include raw JSON-RPC logs in JSON output under _rpcLogs |
--format <format> | human on TTY, json when piped | Output format (json or human; junit-xml is available on OAuth conformance commands only) |
-v, --version | Print the CLI version |
server commands
All server commands accept the shared connection flags below, plus command-specific options.
Shared connection flags
| Flag | Description |
|---|---|
--transport <transport> | Explicit transport type (http or stdio) |
--url <url> | HTTP MCP server URL |
--access-token <token> | Bearer access token |
--oauth-access-token <token> | OAuth bearer access token |
--refresh-token <token> | OAuth refresh token |
--client-id <id> | OAuth client ID (with --refresh-token) |
--client-secret <secret> | OAuth client secret (with --refresh-token) |
--header <header> | HTTP header Key: Value (repeatable) |
--client-capabilities <json> | Client capabilities JSON object |
--command <command> | Stdio server command |
--args <arg...> | Preferred stdio command arguments |
--command-args <arg> | Legacy stdio command argument (repeatable) |
-e, --env <env...> | Stdio environment KEY=VALUE values |
--cwd <path> | Working directory for the stdio child process |
--url vs --command when
--transport is omitted. Use --transport http|stdio when you want an
explicit validation step.
For stdio targets, child processes inherit the parent shell environment by
default. -e/--env adds or overrides child env values, and structured debug
artifacts only record the explicit env keys you passed on the command line.
server probe
No additional flags beyond shared connection flags.
server doctor
| Flag | Description |
|---|---|
--out <path> | Write the doctor JSON artifact to a file |
server info
No additional flags.
server validate
No additional flags.
server ping
No additional flags.
server capabilities
No additional flags.
server export
No additional flags.
tools commands
tools list
Uses shared connection flags.
tools call
| Flag | Description |
|---|---|
--tool-name <name> | Name of the tool to call |
--name <name> | Legacy alias for --tool-name |
--tool-args <json> | Tool arguments as a JSON string |
--params <json> | Legacy alias for --tool-args |
--debug-out <path> | Write debug artifact to file |
resources commands
resources list
Uses shared connection flags.
resources read
| Flag | Description |
|---|---|
--resource-uri <uri> | URI of the resource to read |
--uri <uri> | Legacy alias for --resource-uri |
resources templates
Uses shared connection flags.
prompts commands
prompts list
Uses shared connection flags.
prompts get
| Flag | Description |
|---|---|
--prompt-name <name> | Name of the prompt |
--name <name> | Legacy alias for --prompt-name |
--prompt-args <json> | Prompt arguments as a JSON string |
oauth commands
oauth login
| Flag | Required | Default | Description |
|---|---|---|---|
--url <url> | Yes | MCP server URL | |
--protocol-version <v> | Yes | 2025-03-26, 2025-06-18, or 2025-11-25 | |
--registration <s> | Yes | cimd, dcr, or preregistered | |
--auth-mode <m> | No | interactive | headless, interactive, or client_credentials |
--client-id <id> | No | OAuth client ID | |
--client-secret <s> | No | OAuth client secret | |
--client-metadata-url <url> | No | CIMD metadata document URL | |
--redirect-url <url> | No | Auto-generated | OAuth redirect URL |
--scopes <scopes> | No | Space-separated scope string | |
--header <header> | No | HTTP header Key: Value (repeatable) | |
--step-timeout <ms> | No | 30000 | Per-step timeout |
--verify-tools | No | After login, list tools | |
--verify-call-tool <name> | No | Also call the named tool | |
--debug-out <path> | No | Write debug artifact to file |
oauth conformance
| Flag | Required | Default | Description |
|---|---|---|---|
--url <url> | Yes | MCP server URL | |
--protocol-version <v> | Yes | 2025-03-26, 2025-06-18, or 2025-11-25 | |
--registration <s> | Yes | cimd, dcr, or preregistered | |
--auth-mode <m> | No | interactive | headless, interactive, or client_credentials |
--client-id <id> | No | OAuth client ID | |
--client-secret <s> | No | OAuth client secret | |
--client-metadata-url <url> | No | CIMD metadata document URL | |
--redirect-url <url> | No | Auto-generated | OAuth redirect URL |
--scopes <scopes> | No | Space-separated scope string | |
--header <header> | No | HTTP header Key: Value (repeatable) | |
--step-timeout <ms> | No | 30000 | Per-step timeout |
--verify-tools | No | After OAuth, list tools | |
--verify-call-tool <name> | No | Also call the named tool | |
--conformance-checks | No | Run additional negative OAuth checks, including DCR redirect URI policy and redirect-mismatch probes | |
--print-url | No | Print consent URL to stderr (interactive only) |
oauth conformance-suite
| Flag | Required | Default | Description |
|---|---|---|---|
--config <path> | Yes | Path to JSON config file | |
--verify-tools | No | Enable tool listing on all flows | |
--verify-call-tool <name> | No | Call the named tool after listing |
oauth metadata
| Flag | Required | Description |
|---|---|---|
--url <url> | Yes | OAuth metadata URL to fetch |
oauth proxy / oauth debug-proxy
| Flag | Required | Default | Description |
|---|---|---|---|
--url <url> | Yes | OAuth request URL | |
--method <method> | No | GET | HTTP method |
--header <header> | No | HTTP header Key: Value (repeatable) | |
--body <value> | No | Request body (JSON or raw string) |
protocol commands
protocol conformance
| Flag | Required | Default | Description |
|---|---|---|---|
--url <url> | Yes | MCP server URL | |
--access-token <token> | No | Bearer access token | |
--header <header> | No | HTTP header Key: Value (repeatable) | |
--check-timeout <ms> | No | 15000 | Per-check timeout in milliseconds |
--category <category> | No | all | Restrict checks to one or more categories |
--check-id <id> | No | all | Restrict checks to one or more check IDs |
--format json and --format human. junit-xml is not supported on protocol conformance.
apps commands
Shared connection flags
| Flag | Description |
|---|---|
--transport <transport> | Explicit transport type (http or stdio) |
--url <url> | HTTP MCP server URL |
--access-token <token> | Bearer access token |
--oauth-access-token <token> | OAuth bearer access token |
--refresh-token <token> | OAuth refresh token |
--client-id <id> | OAuth client ID (with --refresh-token) |
--client-secret <secret> | OAuth client secret (with --refresh-token) |
--header <header> | HTTP header Key: Value (repeatable) |
--client-capabilities <json> | Client capabilities JSON object |
--command <command> | Stdio server command |
--args <arg...> | Preferred stdio command arguments |
--command-args <arg> | Legacy stdio command argument (repeatable) |
-e, --env <env...> | Stdio environment KEY=VALUE values |
--cwd <path> | Working directory for the stdio child process |
--url implies HTTP, --command implies stdio, and --transport is an
optional explicit override.
apps conformance
MCP Apps server-side conformance checks. Uses shared connection flags plus:
| Flag | Description |
|---|---|
--category <category> | Check category to run (tools, resources). Repeatable |
--check-id <id> | Specific check id to run. Repeatable |
apps mcp-widget
Fetch hosted-style MCP App widget content.
| Flag | Required | Description |
|---|---|---|
--resource-uri <uri> | Yes | Widget resource URI |
--uri <uri> | No | Legacy alias for --resource-uri |
--tool-id <id> | Yes | Tool call ID used for runtime injection |
--tool-name <name> | Yes | Tool name used for runtime injection |
--tool-input <json> | No | Tool input payload as JSON |
--tool-output <json> | No | Tool output payload as JSON |
--theme <theme> | No | Widget theme: light or dark |
--csp-mode <mode> | No | CSP mode: permissive or widget-declared |
--template <uri> | No | Optional ui:// template override |
--view-mode <mode> | No | Widget view mode |
--view-params <json> | No | Widget view params as JSON |
apps chatgpt-widget
Fetch hosted-style ChatGPT App widget content.
| Flag | Required | Description |
|---|---|---|
--resource-uri <uri> | Yes | Widget resource URI |
--uri <uri> | No | Legacy alias for --resource-uri |
--tool-id <id> | Yes | Tool call ID used for runtime injection |
--tool-name <name> | Yes | Tool name used for runtime injection |
--tool-input <json> | No | Tool input payload as JSON |
--tool-output <json> | No | Tool output payload as JSON |
--tool-response-metadata <json> | No | Tool response metadata as a JSON object |
--theme <theme> | No | Widget theme: light or dark |
--csp-mode <mode> | No | CSP mode: permissive or widget-declared |
--locale <locale> | No | Locale override |
--device-type <type> | No | Device type: mobile, tablet, or desktop |
Exit codes
| Code | Meaning |
|---|---|
0 | Success / all checks passed |
1 | Command ran but reported a failure |
2 | Invalid arguments or configuration |