Use the list command to display all known profiles from the registry and verify their on-disk status. This topic explains the command syntax, available flags, and sample output.

Syntax

./mcpgen list [options]

This command retrieves profile information from the registry and optionally performs live inspection of container status.

Flags for the list Command

The following table lists the flags supported by the list command, along with their purpose and detailed usage notes.
Flag Purpose Notes
--json Outputs the profile list in machine-readable JSON format. Use this flag when integrating with automation tools or scripts that require structured data.
--wide Displays extended profile details. Adds columns for port, TLS mode, mTLS status, OpenAPI spec path, service account status, and prompt configuration.
--profiles Prints only profile names, one per line. Useful for scripting scenarios where you need a simple list of profile names for batch operations.
--status Forces a refresh of container status. Performs a live inspection instead of relying on cached registry data. Recommended when container state may have changed.

Sample output

The following example shows the output of the list command with the --wide flag:
NAME      PORT TLS  MTLS  SPEC            SA  PROMPTS  CREATED
myprof    8500 yes  no    openapi.yml     yes yes      2025-10-11T07:22:14Z