# agent mcp list (Developer Preview)

List the MCP servers registered in the API Catalog.

:::note
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.
:::

## 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<br><br>Override the api version used for api requests made by this command                                                                               |
| `--flags-dir`    | N/A               | **Type:** Value<br><br>Import flag values from a directory.                                                                                                              |
| `--json`         | N/A               | **Type:** Boolean<br><br>Format output as json.                                                                                                                          |
| `--label`        | N/A               | **Type:** Value<br><br>Filter the MCP servers by label.                                                                                                                  |
| `--status`       | N/A               | **Type:** Value<br>**Valid Values:** `ACTIVE`, `DISCONNECTED`<br><br>Filter the MCP servers by connection status. Only ACTIVE and DISCONNECTED are supported as filters. |
| `--target-org`   | `-o`              | **Type:** Value<br>**Required**<br><br>Username or alias of the target org. Not required if the `target-org` configuration variable is already set.                      |
| `--type`         | N/A               | **Type:** Value<br>**Valid Values:** `EXTERNAL`<br><br>Filter the MCP servers by type.                                                                                   |

## Examples for agent mcp list

List all MCP servers in the default target org:

```shell
sf agent mcp list --target-org myOrg
```

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

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