Microsoft MCP management MCP server reference (preview)

Note

This article describes features used in agents or agent flows powered by the standard harness.

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 Environment-level URL Display name Scope
MCPManagement https://agent365.svc.cloud.microsoft/mcp/environments/{environmentId}/servers/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 (can't contain whitespace)

Optional parameters:

  • displayName (string): Display name for the MCP server

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

  • scope (string): Scope for the MCP server

  • audience (string): 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): New name for the MCP server

  • description (string): 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

PublishMCPServer

Publishes an environment-level MCP server to tenant scope.

Required parameters:

  • envId (string): The environment ID of the target MCP server

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

  • alias (string): The name for the published MCP server

  • displayName (string): Display name for the published MCP server. Must be unique among published MCP servers and contain a maximum of 30 characters.

Optional parameters:

  • publisherName (string): Publisher name shown in the Microsoft Admin Center. This parameter is required for custom, user-created MCP servers.

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): New description for the tool

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

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

  • annotations (string): 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): Name for the tool. If you don't provide this parameter, the custom API unique name is used.

  • description (string): 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): Name for the tool. If you don't provide a name, the tool uses the sdkMessage unique name.

  • description (string): 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): Name for the tool. If you don't provide this parameter, the custom API unique name is used.

  • description (string): 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): 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): Tool ID

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

Optional parameters:

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

  • description (string): 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
  • Last updated on