Tool Reference

The tools your client sees depend on your role. Tools marked admin are hidden unless you are a workspace admin or owner. ? marks an optional parameter.

Start here. Most work is one loop: start_agent to kick off, get_agent_status to watch, get_plan / continue_agent to approve the plan and send follow-ups. The rest are for managing references, connections, and the Library.

Agents & tasks

Tool	What it does	Parameters
`start_agent`	Start a headless agent that builds in a Salesforce org; returns an `agentId`	`name`, `prompt`, `mode?` (plan / build, default build), `referenceIds?`, `connectionIds?`
`list_agents`	Compact index of your agents	`limit?` (1–100), `workbenchId?`
`continue_agent`	Send a follow-up message or approve a plan	`agentId`, `message`, `mode?` (plan / build)
`switch_agent_mode`	Flip between plan and build without a message	`agentId`, `mode` (plan / build)
`get_agent_status`	Current state, what it's waiting for, a summary, recent messages, and artifacts	`agentId`
`get_plan`	Show an agent's plan and its approval state	`agentId`
`edit_plan`	Revise the plan with an instruction; the agent re-plans	`agentId`, `instruction`

Some agents can't be driven from MCP — for example ones started in an older version, or that use a desktop-only connection. list_agents flags these, and continue_agent explains why if you try.

Artifacts

Tool	What it does	Parameters
`list_artifacts`	Compact index of an agent's artifacts	`agentId`
`get_artifact`	Render one artifact (Markdown, or an interactive widget for HTML if your client supports it)	`artifactId`

References

Tool	What it does	Parameters
`reference_get`	Get a reference by ID	`id`
`reference_list`	List your workspace references, or the references attached to one agent	`agentId?`, `category?`, `subType?`, `includePublic?` (default false), `limit?` (1–100, default 50), `offset?`
`reference_create`	Create a document reference from Markdown	`name`, `content`, `description?`
`reference_update`	Update a reference you own	`id`, `name?`, `description?`, `category?`, `subType?`, `metadata?`
`discover_references`	Keyword search across your own and shared-with-you references	`query`, `scope?` (own / shared / all, default all), `limit?` (1–100)

Publishing a reference to your workspace isn't done over MCP — it goes through admin review (see the Library admin tools below). Ask an admin, or publish from the app.

Attach & detach

Tool	What it does	Parameters
`attach_reference`	Attach a reference to an agent (takes effect live if it's running)	`agentId`, `referenceId`
`detach_reference`	Detach a reference from an agent	`agentId`, `referenceId`
`attach_connection`	Attach a connection, such as a Salesforce org	`agentId`, `connectionId`
`detach_connection`	Detach a connection from an agent	`agentId`, `connectionId`

Connections

Tool	What it does	Parameters
`list_connections`	List connections you can attach to an agent (server-stored connections only)	—
`get_connection`	One connection, plus the agents using it	`connectionId`

Workbenches

Tool	What it does	Parameters
`list_workbenches`	Compact index of your workbenches	—
`get_workbench`	Full detail of one workbench	`workbenchId`
`create_workbench`	Create a workbench	`name`, `description?`, `connectionIds?`, `referenceIds?`
`get_recent_activity`	Overview of your workbenches, their agents, and any agents not in a workbench	`limit?` (1–200, default 25)

Identity

Tool	What it does	Parameters
`get_user_details`	Your identity — email, name, and workspace	—

Workspace activity

See what others in your workspace are doing — a team-wide feed of recently completed agent runs, not just your own.

Tool	What it does	Parameters
`get_workspace_activity_feed`	Recent completed agent runs across your whole workspace	`limit?` (1–100), `cursor?`

Team activity isn't turned on for every workspace. If it's off for yours, this tool returns an error explaining that — reach out to your admin to enable it.

Library — read

Tool	What it does	Parameters
`library_search`	Search the Library by scope (mine / starred / shared / discovery / featured / skills; admins also `review`)	`scope?` (default discovery), `search?`, `limit?` (1–100), `offset?`
`collection_list`	List Discovery collections, or the references in one collection	`search?`, `collectionId?`, `limit?`

Library — admin

These tools are only visible to workspace admins and owners.

Tool	What it does	Parameters
`review_queue_list`	List references pending publish review	`limit?`, `offset?`
`reference_review`	Approve or deny a publish request	`requestId`, `decision` (approve / deny), `note?`
`reference_set_featured`	Set or clear a reference's featured rank in Discovery	`referenceId`, `featuredRank` (0–100000, or null to clear)
`reference_publish_admin`	Publish a reference directly, skipping review	`referenceId`
`reference_update_admin`	Edit any reference's title, description, or tags	`referenceId`, `name?`, `description?`, `tags?`
`collection_create`	Create a Discovery collection	`name`, `description?`
`collection_add_references`	Add references to a collection	`collectionId`, `referenceIds` (1–100)
`collection_remove_reference`	Remove a reference from a collection	`collectionId`, `referenceId`

Tool Reference

On this page