Skip to main content

Tool visibility

Updated on 3 November 2026.

Choose what AI agents can discover and call on an MCP server. Classic settings use per-tool switches; the Policy Engine can decide listing, calling, and returning results separately.

Choose the instructions for the mode that governs your MCP Gateway. See Switching from classic settings for what happens to stored settings when the engine is on.

Going further with the Policy Engine​

Open Govern > Policy Engine > MCP Gateway > Controls > Invocation & Discovery. This single panel replaces the separate Discovery Visibility and Invocation entry points. Its sections are Tool calls, Resource reads, and Prompt fetches.

Each configuration can decide one or more access steps:

StepWhat it decides
ListedWhether the capability appears in discovery results.
CallableWhether a tool call, resource read, or prompt fetch can run.
ResultWhether its result can return to the client.

The What happens at each step table shows the steps each rule sets. Unset means that rule does not decide the step. A step is denied unless a matching rule allows it. For each decision, the highest numeric priority wins and Deny wins ties.

Allow or block tools​

  1. Choose a recipe such as Allow tools on a server, Allow selected tools, Block a tool, or Block destructive tools.
  2. Set Applies to and choose the server, tools, and caller conditions you need.
  3. Check the steps the rule changes and its Reads as summary.
  4. Save to draft, test the situation in Test, and review and publish.

Hide from listings only changes discovery, not permission to call by name. An AI app may cache an old list, so use Block a tool when both listing and calling must stop. Argument-dependent recipes refuse matching calls; arguments are not available when a tool list is built.

Use Read-only tools, confirm the rest or Allow and require confirmation when tools should remain callable with user confirmation. The separate Human Confirmation control manages confirmation rules and exemptions.

Resources, prompts and results​

Resource recipes can match URI, template, name or MIME type; prompt recipes can match a prompt name. Result recipes can withhold unsuccessful or oversized results. A condition on the returned result belongs to the result step, rather than discovery.

Open Activity to investigate observed matches. Use Test > Try a situation or Replay activity to check the candidate rules before publishing.