feat: surface MCP asset descriptions and metadata in readable output - #464
Draft
Christian-Vallejos wants to merge 1 commit into
Draft
Conversation
Christian-Vallejos
force-pushed
the
t/api-catalog/mcp-asset-descriptions
branch
from
July 24, 2026 17:08
54203ce to
1ef5f77
Compare
@W-23572634@ The Connect API already returns descriptions, labels, auth type and (on fetch) a per-tool security warning, but the human-readable tables dropped them. This brings `sf agent mcp` output to parity with the API so a user can review a tool before approving it, without needing --json. - fetch / asset list / asset replace / create: add Label + Description columns (create now prints the discovered-asset table instead of just a count). - fetch: add a Security Warning column (only /fetch populates it). - list / get: add Auth Type + Description. --json output is unchanged (it always carried the full object). Requires @salesforce/agents with the securityWarning field (forcedotcom/agents#322); schemas regenerated for fetch + create. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Christian-Vallejos
force-pushed
the
t/api-catalog/mcp-asset-descriptions
branch
from
July 25, 2026 18:49
1ef5f77 to
a20e285
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
The
sf agent mcpcommands drop several fields that the Connect API already returns, so a user only sees them via--json. This brings the human-readable output to parity with the API — most importantly the per-tool description and security warning, so a tool can be reviewed before it is approved.fetchLabel,Description,Security Warning(only/fetchpopulates it)asset listLabel,Descriptionasset replaceLabel,Description,Agent ActioncreateDiscovered N asset(s)listAuth Type,DescriptiongetAuth Type,Description--jsonoutput is unchanged (it always carried the full object).Why
Before approving an MCP tool as an agent action, a user needs to read its description and any security warning. Today that information is returned by the API but hidden from the default CLI output.
Dependency
securityWarning?: stringonMcpFetchedAssetcomes from feat: add securityWarning to McpFetchedAsset forcedotcom/agents#322.agent mcp fetch/agent mcp createwere regenerated to include the new field.Test plan
tsc+eslintcleanmocha test/commands/agent/mcp/mcp.test.ts— 18/18 passing (added coverage asserting theDescriptionandSecurity Warningcolumns render)schema:compareclean after regenerationbuild+testgate green@W-23572634@