Fetch the live assets (tools, prompts, resources) advertised by an MCP server.
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 fetch
Performs a live fetch against the configured MCP server identified by its ID, returning the assets (MCP tools, prompts, and resources) it currently advertises along with their status and activation state. Use this to refresh the view of what an MCP server exposes before activating its assets as agent actions.
Flags
| Flag Name (Long) | Flag Name (Short) | Description |
|---|---|---|
| <code>‑‑api‑version</code> | N/A | Type: Value<br><br>Override the api version used for api requests made by this command |
| <code>‑‑flags‑dir</code> | N/A | Type: Value<br><br>Import flag values from a directory. |
| <code>‑‑json</code> | N/A | Type: Boolean<br><br>Format output as json. |
| <code>‑‑mcp‑server‑id</code> | <code>‑i</code> | Type: Value<br>Required<br><br>ID of the MCP server to fetch assets from. |
| <code>‑‑target‑org</code> | <code>‑o</code> | Type: Value<br>Required<br><br>Username or alias of the target org. Not required if the target-org configuration variable is already set. |
Examples for agent mcp fetch
Fetch the assets advertised by an MCP server in the default target org:
sf agent mcp fetch --target-org myOrg --mcp-server-id 0XSxx0000000001
Fetch MCP server assets and output as JSON:
sf agent mcp fetch --target-org myOrg --mcp-server-id 0XSxx0000000001 --json