Rediger

The Business Central Admin Center API MCP server (preview)

The Business Central administration center API provides a Model Context Protocol (MCP) server that exposes Business Central administration center APIs in a standardized, self‑describing way. MCP‑compatible AI agents can discover available admin operations, understand context, and perform environment management tasks.

Using tools like Visual Studio Code, administrators can ask questions such as environment update status, available upgrades, or installed extensions, and receive structured responses sourced directly from the Admin Center. Agents can also propose follow‑up actions; such as copying an environment to a sandbox, scheduling an update, or investigating a failed upgrade, while keeping the user in control through explicit confirmation steps.

Important

Location

The Business Central administration center API MCP server is located at the following URL:

https://mcp.businesscentral.dynamics.com/admin/v1

Connect to the MCP server in Visual Studio Code, Copilot Studio, or any other tool that supports MCP.

Multitenancy

Partners administering environments for multiple customers using granular delegated admin privileges (GDAP) might want to use this MCP server to administer environments across customer tenants. During public preview, this endpoint supports the same single-tenant authentication as other Business Central administration center API endpoints. To facilitate multi‑tenant administration, partners can refer to a sample MCP Proxy available on GitHub that illustrates how requests might be routed to different target tenants.

The sample MCP Proxy is provided as‑is, for reference purposes only, and is not supported or intended for production use. Partners assume full responsibility for any use, modification, or deployment of the sample.

Excluded tools

The MCP server includes all tools available in the Business Central administration center API, except for endpoints that might disrupt an environment if called unintentionally. The following API endpoints are excluded during the public preview:

Set security group - excluded during public preview

POST /admin/{apiVersion}/applications/{applicationFamily}/environments/{environmentName}/settings/securitygroupaccess

Clear security group - excluded during public preview

DELETE /admin/{apiVersion}/applications/{applicationFamily}/environments/{environmentName}/settings/securitygroupaccess

Delete environment - excluded during public preview

DELETE /admin/{apiVersion}/applications/{applicationFamily}/environments/{environmentName}

Rename environment - excluded during public preview

POST /admin/{apiVersion}/applications/{applicationFamily}/environments/{environmentName}/rename

Link Power Platform environment - excluded during public preview

POST /admin/{apiVersion}/bap/applications/{applicationFamily}/environments/{environmentName}/linkEnvironment?powerPlatformEnvironmentId={id}

Unlink Power Platform environment - excluded during public preview

POST /admin/{apiVersion}/bap/applications/{applicationFamily}/environments/{environmentName}/unlinkEnvironment?powerPlatformEnvironmentId={id}

Uninstall app - excluded during public preview

POST /admin/{apiVersion}/applications/{applicationFamily}/environments/{environmentName}/apps/{appId}/uninstall

Business Central Administration Center API reference

  • Last updated on