Skip to main content
Use the Tools tab on a Remote or TrueFoundry-managed MCP server to control which tools agents can call, override how they appear to the LLM, and choose whether newly discovered upstream tools are exposed automatically. MCP server Tools tab showing per-tool toggles, Enable new tools by default turned on, and Bulk Action button

When to use

Use tool management when you need to:
  • Reduce tool surface area - hide tools an agent should never call (for example, destructive write operations).
  • Expose only what you need - turn on a small set of tools for a specific workflow.
  • Improve LLM tool selection - override upstream descriptions or mark tools as read-only or destructive.
  • Gate new upstream tools - decide whether tools added by the MCP server vendor are auto-enabled or require explicit approval.

Open the Tools tab

  1. Open an MCP server from MCP Gateway.
  2. Go to the Tools tab.
Each tool row shows an enable/disable control, Try (test the tool in the playground), and Edit (customize metadata). Try is disabled when the tool is turned off.

Default tool mode

Use Enable new tools by default at the top of the Tools tab to control what happens when the upstream MCP server adds new tools. When the toggle is on, every tool is available to agents unless you turn it off. New tools from the upstream server are enabled automatically, so you do not need to revisit the Tools tab each time the vendor ships a new capability. When the toggle is off, only tools you explicitly enable are available. New upstream tools stay hidden until you turn them on - useful when you want a fixed, curated set of tools and do not want unexpected additions exposed to agents.

Enable or disable a single tool

Toggle a tool on or off on its row. Changes save immediately and show a Tool settings updated toast. Disabled tools are omitted from tools/list responses to MCP clients and cannot be invoked. Tool settings updated toast after saving changes with one tool disabled

Bulk enable or disable tools

Click Bulk Action to edit many tools at once. In bulk mode, each tool shows a checkbox instead of a toggle. Use Select all to check or uncheck every tool. After completing the selection, click Save. Bulk edit mode with all tools selected and Save and Cancel buttons visible Bulk edit mode with two of four tools selected before saving After Save, bulk mode closes, toggles reflect the persisted state, and you see the Tool settings updated toast. Tools tab after bulk save with Enable new tools by default off and two tools enabled

Edit tool description and annotations

Click the pencil icon on a tool to open Edit Tool. Use Reset to Default to remove overrides for that tool. Save Changes to persist the update. Edit Tool modal with description field and MCP Tool Annotations selector