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
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-server
Using uv:
uv pip install mcp-business-central-server
Claude 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\activate
- Install 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-company - Run 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_server
License
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2025 sofias tech
Metadata
Release files for mcp-business-central-server 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_business_central_server-0.1.2.tar.gz | 8.2 kB | Without provenance | Details for mcp_business_central_server-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_business_central_server-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for mcp_business_central_server-0.1.2-py3-none-any.whl |
Total release size: 16.4 kB
Release files / mcp_business_central_server-0.1.2.tar.gz
| Download URL | mcp_business_central_server-0.1.2.tar.gz |
|---|---|
| Size | 8.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
28c8b709a831c10d0bfa96a3eb682681cdfcbc8fd66ccb4cf5552324338d0dac
|
|
BLAKE2b-256 checksum How to use checksums |
34b93dec023d206a5ceb256a5bef80a500e19cbacbfc5c07a528a755edebc1ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.5
|
Release files / mcp_business_central_server-0.1.2-py3-none-any.whl
| Download URL | mcp_business_central_server-0.1.2-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8eef08a4b19e3e722bbd0334b38fabb701a1b0f80344c12de4044b47a316bc6c
|
|
BLAKE2b-256 checksum How to use checksums |
af1e228efae9c87dfa4ea690e21c9e575e577eb7825f270712f6b6c3b22acfa3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.5
|
Security for mcp-business-central-server 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.