Microsoft MCP management MCP server reference (preview)

Important

This is a preview feature.

• Microsoft releases preview features before an official release so that customers can get early access and provide feedback.
• Preview features have restricted functionality and aren't meant for production use.
• Microsoft might change preview MCP tool names and parameters. Avoid hard-coded dependencies. Microsoft maintains scenario support.
• Preview features are subject to Microsoft supplemental terms of use.

Overview

Server ID	Display name	Scope
MCPManagement	Microsoft management MCP server	McpServers.Management.All

Available tools

MCP server management tools

GetMCPServers

Gets all MCP server instances in the current environment.

Input Schema: No parameters required

GetMCPServer

Gets detailed information about a specific MCP server.

Required parameters:

• mcpServerName (string): The unique name of the MCP server to retrieve

CreateMCPServer

Creates a new MCP server instance in the current environment.

Required parameters:

• serverName (string): The name for the new MCP server (must not contain whitespaces)

Optional parameters:

• displayName (string): Optional display name for the MCP server

• description (string): Optional description of what this server is used for

• scope (string): Optional scope for the MCP server

• audience (string): Optional audience for the MCP server

UpdateMCPServer

Updates an existing MCP server instance.

Required parameters:

• mcpServerName (string): The unique name of the MCP server to update

Optional parameters:

• serverName (string): Optional new name for the MCP server

• description (string): Optional new description for the MCP server

DeleteMCPServer

Deletes an MCP server instance.

Required parameters:

• mcpServerName (string): The unique name of the MCP server to delete

BlockMCPServer

Blocks a published MCP server.

Required parameters:

• mcpServerName (string): The name of the MCP server to block

Tool management

GetTools

Gets all tools in a specific MCP server.

Required parameters:

• mcpServerName (string): The unique name of the MCP server to get tools from

GetTool

Gets detailed information about a specific tool.

Required parameters:

• mcpServerName (string): The unique name of the MCP server containing the tool

• toolName (string): The unique name of the tool to retrieve

UpdateTool

Updates an existing tool in an MCP server.

Required parameters:

• mcpServerName (string): The unique name of the MCP server containing the tool

• toolName (string): The unique name of the tool to update

Optional parameters:

• description (string): Optional new description for the tool

• inputSchema (string): Optional JSON schema defining the tool's input parameters

• customAPIId (string): Optional custom API identifier to associate with this tool

• annotations (string): Optional JSON annotations for the tool

DeleteTool

Deletes a tool from an MCP server.

Required parameters:

• mcpServerName (string): The unique name of the MCP server containing the tool

• toolName (string): The unique name of the tool to delete

Custom API tools

GetCustomAPIs

Gets all available custom APIs in the current environment.

Input Schema: No parameters required

CreateToolWithCustomAPI

• Creates a new tool with a custom API in an MCP server.

Required parameters:

• mcpServerName (string): The unique name of the MCP server to add the tool to.

• customAPIId (string): The unique identifier of the custom API to associate with this tool

Optional parameters:

• toolName (string): Optional name for the tool. If you don't provide this parameter, the custom API unique name is used.

• description (string): Optional description of what this tool does

SDK message tools

CreateToolWithSdkMessage

Creates a new tool with an sdkMessage in an MCP server.

Required parameters:

• mcpServerId (string): The unique identifier of the MCP server to add the tool to.

• sdkMessagepairId (string): The unique identifier of the sdkMessage to associate with this tool.

Optional parameters:

• toolName (string): Optional name for the tool. If you don't provide a name, the tool uses the sdkMessage unique name.

• description (string): Optional description of what this tool does.

Remote API tools

CreateToolWithRemoteAPI

Creates a new tool with a remote API in an MCP server.

Required parameters:

• mcpServerName (string): The unique name of the MCP server to add the tool to.

• remoteApiId (string): ID of the remote API.

Optional parameters:

• toolName (string): Optional name for the tool. If you don't provide this parameter, the custom API unique name is used.

• description (string): Optional description of what this tool does.

Connector tools

GetConnectorsAsync

Gets all connectors.

Input Schema: No parameters required

GetConnectorAsync

Gets a specific connector.

Required parameters:

• connectorId (string): The unique name of the connector to retrieve

GetConnectorOperationsAsync

Gets operations for a specific connector.

Required parameters:

• connectorId (string): The unique name of the connector to retrieve

CreateToolWithConnector

Creates a new tool with a connector in an MCP server.

Required parameters:

• toolName (string): Name for the tool

• mcpServerName (string): The unique name of the MCP server to add the tool to.

• connectorId (string): The name of the connector to associate with this tool

• operationId (string): The unique identifier of the connector operation to associate with this tool

Optional parameters:

• description (string): Optional description of what this tool does.

Graph API tools

GetGraphApisAsync

Gets all Microsoft Graph APIs.

Input Schema: No parameters required

CreateToolWithGraph

Creates a new tool with a Graph API operation in an MCP server.

Required parameters:

• toolId (string): ToolId

• mcpServerName (string): The unique name of the MCP server to add the tool to.

Optional parameters:

• toolName (string): (optional) The name to set for the tool

• description (string): (optional) The description to set for the tool

Dataverse environment tools

ListDataverseEnvironments

Lists all available Dataverse environments.

Input Schema: No parameters required

ListMCPServersInDataverseEnvironment

Lists all MCP servers in a specific Dataverse environment.

Required parameters:

• envId (string): The environment ID to list MCP servers from.