demiliani avatar

Dynamics 365 Business Central Admin

demiliani/d365bcadminmcp

Administer Business Central environments, apps, PTEs, updates and exports via the Admin Center API.

GitHub stars
13
tools
52
transport
STDIO
env vars
2
last updated
Nov 17, 2026

Tools

52 tools

Public tool metadata for what this MCP can expose to an agent.

get_microsoft_entra_id_tokenSign in to a tenant and cache the token used by the other tools (returns status and expiry, never the token)

Sign in to a tenant and cache the token used by the other tools (returns status and expiry, never the token)

No parameter schema in public metadata yet.

force_interactive_authForce browser-based login and refresh the cached token for a tenant

Force browser-based login and refresh the cached token for a tenant

No parameter schema in public metadata yet.

get_tenant_id_from_tenant_nameRetrieve tenant ID from tenant name

Retrieve tenant ID from tenant name

No parameter schema in public metadata yet.

get_environment_informationsList all BC environments in a tenant

List all BC environments in a tenant

No parameter schema in public metadata yet.

create_new_environmentCreate a new BC environment (optionally on a specific ring and application version)

Create a new BC environment (optionally on a specific ring and application version)

No parameter schema in public metadata yet.

copy_environmentCopy an existing environment to create a new one

Copy an existing environment to create a new one

No parameter schema in public metadata yet.

delete_environmentDelete a Business Central environment

Delete a Business Central environment

No parameter schema in public metadata yet.

recover_environmentRecover a recently deleted environment

Recover a recently deleted environment

No parameter schema in public metadata yet.

rename_environmentRename an environment (its URL changes, so integrations must be updated)

Rename an environment (its URL changes, so integrations must be updated)

No parameter schema in public metadata yet.

restore_environmentRestore an environment to a point in time as a new environment

Restore an environment to a point in time as a new environment

No parameter schema in public metadata yet.

get_available_restore_periodsList the time ranges an environment can be restored to

List the time ranges an environment can be restored to

No parameter schema in public metadata yet.

get_environment_operationsList environment operations (create, copy, rename, restore, ...) for the tenant or one environment

List environment operations (create, copy, rename, restore, ...) for the tenant or one environment

No parameter schema in public metadata yet.

get_environment_quotasGet the environment and storage quotas of the tenant

Get the environment and storage quotas of the tenant

No parameter schema in public metadata yet.

get_environment_update_windowGet update window settings for an environment

Get update window settings for an environment

No parameter schema in public metadata yet.

set_environment_update_windowConfigure update window for an environment

Configure update window for an environment

No parameter schema in public metadata yet.

set_environment_application_insights_connection_stringSet Application Insights connection string

Set Application Insights connection string

No parameter schema in public metadata yet.

get_usage_storage_for_environmentGet storage usage for a specific environment

Get storage usage for a specific environment

No parameter schema in public metadata yet.

get_usage_storage_for_all_environmentsGet storage usage for all environments

Get storage usage for all environments

No parameter schema in public metadata yet.

get_environment_companiesList companies in an environment

List companies in an environment

No parameter schema in public metadata yet.

get_installed_appsList apps installed in an environment

List apps installed in an environment

No parameter schema in public metadata yet.

get_available_app_updatesCheck for available app updates

Check for available app updates

No parameter schema in public metadata yet.

install_appInstall a Marketplace (AppSource) app in a Business Central environment

Install a Marketplace (AppSource) app in a Business Central environment

No parameter schema in public metadata yet.

update_appUpdate an app to a specific version

Update an app to a specific version

No parameter schema in public metadata yet.

uninstall_appRemove an app from an environment

Remove an app from an environment

No parameter schema in public metadata yet.

get_app_operationsGet status of app install/update/uninstall operations

Get status of app install/update/uninstall operations

No parameter schema in public metadata yet.

get_environment_updatesCheck for available BC version updates

Check for available BC version updates

No parameter schema in public metadata yet.

set_environment_updateSchedule or run an environment update

Schedule or run an environment update

No parameter schema in public metadata yet.

get_active_sessionsList active user sessions in an environment

List active user sessions in an environment

No parameter schema in public metadata yet.

kill_active_sessionsTerminate a specific active session

Terminate a specific active session

No parameter schema in public metadata yet.

get_environment_notification_recipientList notification recipients

List notification recipients

No parameter schema in public metadata yet.

create_environment_notification_recipientAdd a new notification recipient

Add a new notification recipient

No parameter schema in public metadata yet.

delete_environment_notification_recipientRemove a notification recipient

Remove a notification recipient

No parameter schema in public metadata yet.

get_environment_security_groupGet the Microsoft Entra security group that restricts access to an environment

Get the Microsoft Entra security group that restricts access to an environment

No parameter schema in public metadata yet.

set_environment_security_groupRestrict access to the members of a security group

Restrict access to the members of a security group

No parameter schema in public metadata yet.

clear_environment_security_groupRemove the security group restriction

Remove the security group restriction

No parameter schema in public metadata yet.

get_access_with_m365_licensesCheck whether users can access the environment with Microsoft 365 licenses

Check whether users can access the environment with Microsoft 365 licenses

No parameter schema in public metadata yet.

set_access_with_m365_licensesAllow or disallow access with Microsoft 365 licenses

Allow or disallow access with Microsoft 365 licenses

No parameter schema in public metadata yet.

get_database_export_metricsExports allowed per month and remaining this month

Exports allowed per month and remaining this month

No parameter schema in public metadata yet.

start_database_exportExport the environment database as a .bacpac file to an Azure Storage account

Export the environment database as a .bacpac file to an Azure Storage account

No parameter schema in public metadata yet.

get_available_featuresList available features in an environment

List available features in an environment

No parameter schema in public metadata yet.

activate_featureActivate a feature in a Business Central environment

Activate a feature in a Business Central environment

No parameter schema in public metadata yet.

deactivate_featureDeactivate a feature in a Business Central environment

Deactivate a feature in a Business Central environment

No parameter schema in public metadata yet.

install_pteUpload a PTE (.app, max 50 MB) and install it immediately or on a schedule

Upload a PTE (.app, max 50 MB) and install it immediately or on a schedule

No parameter schema in public metadata yet.

install_ptes_from_folderUpload all .app files in a folder in dependency order, waiting for each immediate install

Upload all .app files in a folder in dependency order, waiting for each immediate install

No parameter schema in public metadata yet.

get_scheduled_pte_operationsList scheduled PTE installs and updates

List scheduled PTE installs and updates

No parameter schema in public metadata yet.

cancel_scheduled_pteCancel a scheduled PTE install or update

Cancel a scheduled PTE install or update

No parameter schema in public metadata yet.

get_extension_deployment_statusGet extension deployment status for an environment/company

Get extension deployment status for an environment/company

No parameter schema in public metadata yet.

create_pte_uploadCreate and upload a single PTE (.app) file

Create and upload a single PTE (.app) file

No parameter schema in public metadata yet.

create_pte_uploads_from_folderBulk upload PTEs from a folder, waiting for each deployment

Bulk upload PTEs from a folder, waiting for each deployment

No parameter schema in public metadata yet.

get_extension_uploadRetrieve the status of a specific extension upload task

Retrieve the status of a specific extension upload task

No parameter schema in public metadata yet.

clear_cached_tokenClear cached authentication token for a tenant

Clear cached authentication token for a tenant

No parameter schema in public metadata yet.

get_token_cache_statusView cached token status for all tenants

View cached token status for all tenants

No parameter schema in public metadata yet.

Sponsors

Configuration

D365BC_MCP_LOG_LEVELdefault: Information

Log level written to stderr

D365BC_MCP_PERSIST_TOKEN_CACHEdefault: true

Keep the Microsoft sign-in in the encrypted OS token cache across restarts

Readme

Dynamics 365 Business Central Admin MCP Server (YAMPI)

A Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop, GitHub Copilot, and Cursor to manage Dynamics 365 Business Central environments through natural language commands.

🌟 Features

  • πŸ” Interactive Authentication - Secure Microsoft Entra ID authentication with browser-based login
  • πŸ“¦ 52 Administrative Tools - Complete environment, app, session, PTE upload, and extension management
  • ⚑ Smart Token Caching - Automatic token refresh to minimize authentication prompts
  • 🌍 Multi-Tenant Support - Manage multiple Business Central tenants seamlessly
  • πŸ’¬ Natural Language Interface - Control BC through conversational AI commands
  • πŸ”’ Secure by Design - No credentials stored, uses Azure authentication standards
  • πŸ›°οΈ Admin Center API v2.29 - Built on the latest Business Central Administration Center API

πŸ“¦ Installation

Via npm (Recommended)

npm install -g @demiliani/d365bc-admin-mcp

To upgrade, run the same command with @latest. Close your AI assistant first (or stop the MCP server): on Windows a running server keeps its executable locked.


View the full README on GitHub

Details

Repository
github.com/demiliani/d365bcadminmcp
Website
github.com/demiliani/D365BCAdminMCP#readme
Package
@demiliani/d365bc-admin-mcp
Transport
STDIO
Registry
MCP registry, active