Microsoft MCP management MCP server reference

Important

You need to be part of the Frontier preview program to get early access to Microsoft Agent 365. Frontier connects you directly with Microsoft’s latest AI innovations. Frontier previews are subject to the existing preview terms of your customer agreements. As these features are still in development, their availability and capabilities may change over time.

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 not provided, uses the custom API unique name)

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

SDK message tools

CreateToolWithSdkMessage

Creates a new tool with a 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 not provided, 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 not provided, uses the custom API unique name)

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

Connector tools

GetConnectorsAsync

Get all connectors.

Input Schema: No parameters required

GetConnectorAsync

Get a specific connector.

Required parameters:

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

GetConnectorOperationsAsync

Get 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

Get 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.