Edit

List tool visibility

Note

  • The tools and examples in this documentation illustrate current capabilities. Tool names, descriptions, parameters, response formats, and available functionality can change over time.
  • When you build agents, integrations, or orchestration logic, don't hard-code dependencies on specific tool names, parameter structures, tool metadata, or response schemas. Instead, design your solution to discover and use available tools at runtime.
  • As the platform evolves, Microsoft might add, remove, rename, or modify tools and tool metadata. Designing against capabilities rather than specific tool identifiers helps maintain compatibility across service updates.

Use this capability when you want to review which tools are visible, hidden, or restored at the organization or profile level.

What it does

This tool lists the current tool visibility settings for the selected scope. It returns the tool catalog, the resolved hidden set, and the raw visibility patches stored for the organization or profile.

Try prompts like

  • Which tools are hidden?
  • Show tool visibility for this organization.
  • List tool visibility for the profile.
  • What tools are disabled?
  • Show me the current tool selection.

What you'll see in chat

The assistant returns a text summary of the visibility state, including the scope, the tool names, and the current hidden or restored status.

Helpful tips

  • Use level: organization to review organization-wide visibility.
  • Use level: profile to inspect a specific profile, and include profileId.
  • This tool is read-only. Use save_tool_selection to make changes.

What happens next

  • Hide the email tools for this profile.
  • Restore a hidden tool.
  • Reset tool visibility to defaults.

Does this change data?

No, this doesn't change data.

It only reads the current visibility configuration.

Prerequisites

This tool is available on the Dynamics 365 Customer Service MCP server. See the availability note at the top of this page for details. No additional configuration is required.

Tool summary

Property Value
User-facing name List tool visibility
Internal tool name list_tool_selection
Purpose Lists the current tool visibility settings for the selected organization or profile scope

Tool behavior

Lists the current tool visibility settings for the selected organization or profile scope. Returns the full tool catalog, the resolved hidden set, and the raw visibility patches that are currently saved.

Annotations

Annotation Value Meaning
readOnlyHint true This tool doesn't modify data.
destructiveHint Not set Not applicable.
idempotentHint Not set Not applicable.
openWorldHint Not set Uses default.

Input concepts

Level

Input Description Required
level, organization, profile level (organization or profile, required). Selects whether to inspect organization-wide or profile-level visibility. Yes

Profile ID

Input Description Required
profileId profileId (UUID string, optional). Required when level is profile. Varies

Response and UI behavior

Response type

Text-only

No interactive component is rendered. Returns structured text describing the current visibility state, including the scope, tool names, and hidden or restored status.

Routing notes

Use list_tool_selection when:

  • You need to confirm which tools are hidden or visible.
  • You want to inspect visibility before making a change.
  • You want a read-only audit of tool selection settings.

Don't use list_tool_selection when:

  • You already know the exact change you want to make. Use save_tool_selection instead.
Tool Relationship
save_tool_selection Saves visibility overrides
delete_tool_selection Clears visibility overrides
browse_agent_config_options Discovers related configuration options

Data mutation classification

Read-only.

This tool only reads the current visibility configuration.

  • Last updated on