agent mcp list (Developer Preview)

List the MCP servers registered in the API Catalog.

This command is available as a developer preview. The command isn’t generally available unless or until Salesforce announces its general availability in documentation or in press releases or public statements. All commands, parameters, and other features are subject to change or deprecation at any time, with or without notice. Don’t implement functionality developed with these commands or tools.

Note

Description for agent mcp list

Returns the Model Context Protocol (MCP) servers registered in the API Catalog, optionally filtered by label, type, or status. Use this to discover which MCP servers are available and inspect their server URLs and current status.

Flags

Flag Name (Long)	Flag Name (Short)	Description
`‑‑api‑version`	N/A	Type: Value Override the api version used for api requests made by this command
`‑‑flags‑dir`	N/A	Type: Value Import flag values from a directory.
`‑‑json`	N/A	Type: Boolean Format output as json.
`‑‑label`	N/A	Type: Value Filter the MCP servers by label.
`‑‑status`	N/A	Type: Value Valid Values: `ACTIVE`, `DISCONNECTED` Filter the MCP servers by connection status. Only ACTIVE and DISCONNECTED are supported as filters.
`‑‑target‑org`	`‑o`	Type: Value Required Username or alias of the target org. Not required if the `target-org` configuration variable is already set.
`‑‑type`	N/A	Type: Value Valid Values: `EXTERNAL` Filter the MCP servers by type.

Examples for agent mcp list

List all MCP servers in the default target org:

1sf agent mcp list --target-org myOrg

List external MCP servers filtered by status and output as JSON:

1sf agent mcp list --target-org myOrg --type EXTERNAL --status ACTIVE --json