Business Central MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Business Central MCP Server show me the schema for Customers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Business Central MCP Server
A lightweight MCP Server for seamless integration with Microsoft Dynamics 365 Business Central, enabling MCP clients to interact with any entity in your Business Central environment. Developed by sofias tech.
Features
This server provides a clean interface to Business Central resources through the Model Context Protocol (MCP), with optimized HTTP request handling for improved performance.
Tools
The server implements the following tools:
BC_Get_Schema: Retrieves the schema of any Business Central entity including available fieldsBC_List_Items: Fetches a list of entities with optional filtering and paginationBC_Get_Items_By_Field: Searches for entities based on a specific field valueBC_Create_Item: Creates a new entity record in Business CentralBC_Update_Item: Updates an existing entity recordBC_Delete_Item: Removes an entity record from Business Central
Related MCP server: MCP Dataverse Server
Working with Business Central Entities
This server can work with any entity (table) in Business Central. When using the tools, you must provide the exact entity name as it appears in Business Central. For example:
EmployeesCustomersItemsVendorsSalesOrdersPayments
The entity name is case-sensitive and must match exactly what Business Central exposes through its API.
Architecture
The server is built with resource efficiency in mind:
Clear separation between resource management and tool implementation
Simple and maintainable codebase with minimal code duplication
Direct HTTP request handling using requests library
Setup
Create API credentials for Business Central
Configure your Business Central environment and company information
Set up the required environment variables
Environment Variables
The server requires these environment variables:
BC_URL_SERVER: Your Business Central API server URL (e.g., "https://api.businesscentral.dynamics.com/v2.0/tenant/api/v2.0")BC_USER: Your Business Central API usernameBC_PASS: Your Business Central API passwordBC_COMPANY: The name of your Business Central company
Quickstart
Installation
pip install -e .Or install from PyPI once published:
pip install mcp-business-central-serverUsing uv:
uv pip install mcp-business-central-serverClaude Desktop Integration
To integrate with Claude Desktop, update the configuration file:
On Windows: %APPDATA%/Claude/claude_desktop_config.json
On macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Standard Integration
"mcpServers": {
"businesscentral": {
"command": "mcp-business-central-server",
"env": {
"BC_URL_SERVER": "your-bc-api-url",
"BC_USER": "your-bc-username",
"BC_PASS": "your-bc-password",
"BC_COMPANY": "your-bc-company"
}
}
}Using uvx
"mcpServers": {
"businesscentral": {
"command": "uvx",
"args": [
"mcp-business-central-server"
],
"env": {
"BC_URL_SERVER": "your-bc-api-url",
"BC_USER": "your-bc-username",
"BC_PASS": "your-bc-password",
"BC_COMPANY": "your-bc-company"
}
}
}Development
Requirements
Python 3.10+
Dependencies listed in
requirements.txtandpyproject.toml
Local Development
Clone the repository
Create a virtual environment:
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activateInstall development dependencies:
pip install -e .Create a
.envfile with your Business Central credentials:BC_URL_SERVER=your-bc-api-url BC_USER=your-bc-username BC_PASS=your-bc-password BC_COMPANY=your-bc-companyRun the server:
python -m mcp_bc_server
Debugging
For debugging the MCP server, you can use the MCP Inspector:
npx @modelcontextprotocol/inspector -- python -m mcp_bc_serverLicense
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2025 sofias tech
Available Tools
6 toolsBC_Create_ItemC
Create a new item in Business Central.
Inputs: resource (required), item_data (required). Returns: result
BC_Delete_ItemC
Delete an item from Business Central.
Inputs: resource (required), item_id (required). Returns: result
BC_Get_Items_By_FieldC
Get items matching a field value.
Inputs: resource (required), field (required), value (required). Returns: result
BC_Get_SchemaC
Get schema information for a Business Central resource.
Inputs: resource (required). Returns: result
BC_List_ItemsC
Get items from Business Central with filtering and pagination.
Inputs: resource (required), filter, top, skip. Returns: result
BC_Update_ItemC
Update an existing item in Business Central.
Inputs: resource (required), item_id (required), item_data (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct action on items (create, delete, get by field, get schema, list, update), with no overlap in purpose.
All tools use a consistent BC_verb_noun pattern in snake_case, though mixing 'Get' and 'List' for item retrieval is a minor inconsistency.
Six tools cover the essential CRUD operations plus schema and filtered lookup, which is well-scoped for an item management server.
Basic CRUD is covered, but there is no explicit get-by-id tool (though BC_Get_Items_By_Field could serve that purpose), leaving a minor gap.
Maintenance
Related MCP Connectors
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Discover, plan and run tools across your connected business systems through one OAuth MCP endpoint
List, read, edit, and deploy your GenMB AI-generated apps from any MCP client.
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to interact with Microsoft Dynamics 365 Business Central through MCP, providing access to customers, items, sales orders, and allowing creation of new records via natural language.2-
- FlicenseNot gradedqualityDmaintenanceEnables CRUD operations and schema exploration on Microsoft Dataverse databases using service principal authentication. It allows users to query records with OData filters, manage table entries, and retrieve metadata through a standardized MCP interface.-
- AlicenseAqualityCmaintenanceModel Context Protocol (MCP) server for Microsoft Dynamics 365 Business Central. Provides AI assistants with direct access to Business Central data through properly formatted API v2.0 calls.610MIT
- AlicenseNot gradedqualityDmaintenanceEnables MCP clients to access and manage Microsoft Dynamics 365 Business Central entities, such as creating sales orders, via a modern async MCP server.MIT