Introducing YAMPI: the MCP server for Dynamics 365 Business Central administration.

At the end of November 2024 Anthropic introduced the Model Context Protocol (MCP), an open standard and open-source framework created with the goal to standardize the way AI systems like large language models (LLMs) integrate and share data with external tools, systems, and data sources.

On April 2025 I was probably the first that launched an idea: why not start introducing MCP functionalities also with Dynamics 365 Business Central? This was the original post. In that post I talked about a prototype of an MCP server I created to administer some tasks in a Business Central environment (prototype that I also showed at DynamicsMinds conference few months after).

Now the MCP protocol is a mature reality and it’s quite everywhere… yes, also in Dynamics 365 Business Central.

But what about that project?

I hope you were one of the attendees at this section at Directions EMEA in Poznan:

In this session me and Duilio talked a lot about managing Business Central environment at scale and we opened some of our tools we created for the partner’s community. And in the last part of the session, this little boy took the stage:

I am pleased to introduce you to YAMPI!

YAMPI (Yet Another MCP for Productivity Increase or maybe simply Yet Another MCP for Pizza’s Injection) is my MCP server for managing customer’s Business Central tenants at scale directly from AI, and you can start using it from now in your favourite AI tool.

Revolutionizing Dynamics 365 Business Central Administration with AI: Introducing the D365 BC Admin MCP Server

In today’s fast-paced business environment, managing multiple Dynamics 365 Business Central environments can be time-consuming and complex. What if you could simply ask your AI assistant to handle these administrative tasks using natural language? That’s exactly what the Dynamics 365 Business Central Admin MCP Server (or YAMPI for friends ) makes possible.

What is the D365 BC Admin MCP Server?

The D365 BC Admin MCP Server is a groundbreaking integration that bridges the gap between AI assistants and Dynamics 365 Business Central administration. Built on the Model Context Protocol (MCP) standard, it enables popular AI tools like GitHub Copilot, Cursor, Claude Desktop, etc. to manage your Business Central environments through conversational commands.

Instead of navigating through multiple Admin Center portals and APIs, you can now simply tell your AI assistant what you need: “Show me all my Business Central environments” or “Update the Sales Module app to version 2.0” — and it happens.

The Vision: AI-Powered Administration

The goal of this project is simple yet transformative: improve and simplify Business Central administration by making it accessible through natural language.

Traditional BC administration requires:

• Deep knowledge of the Admin Center interface
• Understanding of REST APIs and authentication flows
• Switching between multiple tools and portals
• Manual tracking of environment states and updates

With the D365 BC Admin MCP Server, all of this complexity is abstracted away. Business Central administrators can now:

• Manage environments conversationally
• Automate routine tasks through AI
• Reduce the learning curve for new administrators
• Increase productivity by eliminating context switching

Key Features:

Seamless Authentication

The MCP server uses Microsoft Entra ID (formerly Azure AD) for authentication, ensuring enterprise-grade security without compromising convenience.

On first use, a browser window opens for secure authentication. Your credentials are never stored locally. Instead, the server uses intelligent token caching that automatically refreshes tokens for 50 minutes, minimizing authentication prompts while maintaining security.

Comprehensive Administrative Capabilities

The server exposes 28 specialized administrative tools (at the moment) organized into seven key categories:

1. Authentication & Tenant Management (3 tools)

• Intelligent token management with automatic refresh
• Multi-tenant support for managing multiple BC instances
• Token cache status monitoring

2. Environment Management (9 tools)

• List and monitor all environments
• Create new environments on-demand
• Copy existing environments for testing
• Configure update windows
• Set up Application Insights integration
• Monitor storage usage across environments
• Manage companies within environments

3. Application Management (5 tools)

• View installed applications
• Check for available updates
• Update apps to specific versions
• Uninstall applications
• Track app operation status

4. Environment Updates (2 tools)

• Check for Business Central version updates
• Schedule or immediately execute environment updates

5. Session Management (2 tools)

• Monitor active user sessions
• Terminate specific sessions when needed

6. Notification Management (3 tools)

• Manage notification recipients
• Add new recipients for alerts
• Remove notification recipients

7. Feature Management (3 tools)

• Discover available features
• Activate new features
• Deactivate features as needed

Smart and Efficient

The server is designed with efficiency in mind:

• Automatic token refresh eliminates repeated login prompts
• Multi-tenant caching allows seamless switching between tenants
• Minimal overhead — no heavy dependencies or resource consumption
• Fast responses — optimized API calls and caching strategies

Multi-Tenant Architecture

For organizations managing multiple Business Central tenants the MCP server provides native multi-tenant support. Switch between tenants effortlessly, with each maintaining its own secure authentication state.

Natural Language Interface

The real magic happens when you interact with your AI assistant. Here are real-world examples of what becomes possible:

Environment Operations:

"Show me all my Business Central environments"
"What's the status of my Production environment?"
"Create a new sandbox called 'Q4-Testing' in the US region"
"Copy Production to a new sandbox named 'UAT-Environment'"

Application Management:

"List all installed apps in Production"
"Are there any available updates for my apps?"
"Update the Sales Module app to version 2.0"
"Uninstall the Marketing Extension from Sandbox"

Monitoring and Maintenance:

"Show active user sessions in Production"
"What's the storage usage across all my environments?"
"Set the update window for Production to 10 PM - 6 AM UTC"
"Terminate session abc123 in Sandbox"

Who Should Use This?

The D365 BC Admin MCP Server is perfect for:

• Business Central Administrators who want to streamline daily administrative tasks
• DevOps Teams looking to automate environment management
• Consultants managing multiple client tenants
• Developers who need quick environment setup and teardown
• IT Managers seeking efficient ways to monitor BC infrastructure

Getting Started in Minutes

Install the Visual Studio Code extension

The best way to install this MCP Server in your GitHub Copilot is by installing the D365 BC Admin MCP Extension from the Visual Studio Code Marketplace, an extension that automatically installs and configures the Dynamics 365 Business Central Admin MCP server for GitHub Copilot integration:

This extension add the following commands to your Visual Studio Code command palette:

• D365BCAdmin - Install D365 BC Admin MCP Server – Install and configure the MCP server
• D365BCAdmin - Uninstall D365 BC Admin MCP Server – Remove the MCP server and clean up configuration
• D365BCAdmin - Check MCP Server Status – Verify installation and configuration status
• D365BCAdmin - Show System Diagnostics – Display detailed system and extension information

When installed, simply execute the D365BCAdmin - Install D365 BC Admin MCP Server command and the D365 BC Admin MCP server will be automatically installed and configured in your GitHub Copilot for your user (no need to manually configure it). Then you can execute the MCP: Open User Configuration command to see the configuration and start/stop the server.

Direct installation (without VS Code extension):

This is the recommended way if you want to use this MCP server with other MCP clients like Cursor or Claude.

1. Install via npm:

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

1. Configure your AI assistant (GitHub Copilot, Cursor, Claude Desktop, etc) with a simple JSON configuration
2. Start using natural language commands — authentication happens automatically on first use

No complex setup, no credential management, no API key juggling. Just install, configure, and start commanding your Business Central environments through conversation.

Built on Modern Standards

The D365 BC Admin MCP Server leverages cutting-edge technologies:

• Model Context Protocol (MCP) — The emerging standard for AI assistant integrations
• Azure Identity — Enterprise-grade authentication from Microsoft
• Business Central Admin API — Official Microsoft APIs for BC administration
• Node.js 16+ — Modern, efficient runtime environment
• .NET 9

Security by Design

The MCP server follows security best practices:

• No credentials stored locally — all authentication through Microsoft Entra ID
• Token-based authentication with automatic expiration
• Secure browser-based login — no password entry in the application
• Scoped permissions — only accesses what you authorize
• Azure authentication standards — enterprise-proven security model

Why I created this?

This MCP server was initially created for personal usage, but then I realized that it can represents an improvement in how we interact with Business Central administration. By combining the power of AI assistants with the robustness of Microsoft’s admin APIs, it creates a more intuitive, efficient, and accessible administrative experience.

Imagine a future where:

• Junior administrators or consultants can perform complex tasks through guided conversations
• Routine maintenance is automated through AI-driven workflows
• Environment provisioning happens in seconds through natural language
• Troubleshooting begins with “What’s wrong with my environment?”

This future is now available, open-source, and ready to transform your Business Central administration workflow.

Get Involved

The project is open-source and welcomes contributions from the Business Central community. Whether you’re fixing bugs, adding features, or improving documentation, your input helps make BC administration better for everyone.

Ready to revolutionize your BC administration?

Install the D365 BC Admin MCP Server today and experience the power of AI-driven Business Central management. Your environments are just a conversation away.

Visit the npm package to get started, or check out the GitHub repository for documentation and source code.

Made with for the Dynamics 365 Business Central community

Original Post https://demiliani.com/2025/11/11/introducing-yampi-the-mcp-server-for-dynamics-365-business-central-administration/