Microsoft MCP management MCP server reference (preview)

Overview

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.