Remove an MCP Tool Action from an Agent

Delete the agent action that references an MCP tool to remove your agent’s access.

Required Editions

Available in: Lightning Experience
Available in: Enterprise, Performance, Unlimited, and Developer Editions. Required add-on licenses vary by agent type.
User Permissions Needed
To manage agent actions: Manage AI Agents AND the required permissions for your agent type

To make changes to your agent, it must be in a draft state. If you want to make changes to a committed agent, create a new draft of your agent.

Note
Note

These steps cover how to remove an action from your agent in Canvas view, but there are a few ways to remove an action in Agentforce Builder.

  • Ask Agent Optimizer to remove an action for you.
  • Remove the action in Script view.
  1. From the Agents list in the Agentforce Studio app, open the agent you want to remove an action from.
  2. In the Explorer panel, expand the subagent you want to remove the action from.
  3. Hover over the name of the action you want to remove and click Ellipsis menu. Then click Delete.
  4. Open the subagent you removed the action from and delete all references to the action.
  5. Save your changes.

The agent action that references the MCP tool is still available to add to agents in the asset library.