Delete External MCP Registration

Note

This tool is available by default on the following MCP servers: Dynamics 365 Customer Service. 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.

This capability works behind the scenes when you remove an external MCP tool server registration from the registration management widget.

What it does

When you select Delete on an existing MCP server registration in the management widget, this tool removes it from your Dynamics 365 environment. The server's tools are immediately unregistered and are no longer available to the Service Agent.

The deletion also clears cached proxy connections to the removed server, so no further calls are routed to it.

Try prompts like

Not applicable. This tool is called automatically when you delete a registration from the management widget. It is not invoked by typing a prompt.

What you'll see in chat

The registration widget updates to confirm the deletion succeeded and removes the entry from the list. If the deletion fails (for example, the registration was already removed), the widget displays an error message.

Helpful tips

• Deletion is immediate and permanent. There is no undo.
• After deleting a registration, the Service Agent can no longer invoke tools from that server.
• Deleting a registration frees up a slot toward the 20-registration cap for your environment.

What happens next

After deleting, the registration widget returns to the list view. You can:

• "Add a new MCP server"
• "Manage my remaining registrations"

Does this change data?

Yes, this changes data.

Deleting a registration permanently removes a configuration record from your Dynamics 365 environment.

Prerequisites

This tool requires the following:

• System Administrator or Copilot Service administrator role

Tool summary

Property	Value
User-facing name	Delete External MCP Registration
Internal tool name	delete_mcp_registration
Purpose	Removes an external MCP server registration by ID

Tool behavior

Removes an external MCP server registration by ID. This is a widget support tool invoked automatically when users interact with the extensibility registrations widget. It is not intended for direct invocation by the model.

Annotations

Annotation	Value	Meaning
readOnlyHint	false	This tool deletes registration data.
destructiveHint	true	Permanently removes the registration.
idempotentHint	true	Deleting an already-deleted registration is a no-op.
openWorldHint	Not set	Uses default.

Input concepts

Registration ID

Input	Description	Required
id	id (UUID, required). The unique identifier of the registration to delete.	Yes

Organization URL

Input	Description	Required
orgUrl	orgUrl (optional). Overrides the currently selected environment URL.	No

Response and UI behavior

This MCP tool is supported by an MCP App.

Response type

Widget update

The widget refreshes to reflect the removal.

Routing notes

This tool is exclusively called by the manage_mcp_registration widget. Do not invoke it directly.

Related tools

Tool	Relationship
manage_mcp_registration	The launcher tool that opens the registration widget
save_mcp_registration	Creates or updates a registration
test_mcp_registration_connection	Tests connectivity to a server

Data mutation classification

Write (destructive delete). Permanently removes an external MCP server registration from the org-scoped registration store.