What is Mcp Business Central Server

The mcp-business-central-server is a lightweight MCP Server designed for seamless integration with Microsoft Dynamics 365 Business Central, allowing MCP clients to interact with any entity within the Business Central environment.

Use cases

Use cases include managing employee records, customer data, inventory items, vendor information, sales orders, and payment processing within the Business Central framework.

How to use

To use the mcp-business-central-server, you need to create API credentials for Business Central, configure your environment and company information, and set up the required environment variables. You can then utilize various tools to manage Business Central entities.

Key features

Key features include a clean interface to Business Central resources via the Model Context Protocol (MCP), optimized HTTP request handling, and tools for retrieving schemas, listing items, searching, creating, updating, and deleting entities.

Where to use

The mcp-business-central-server is primarily used in business environments that utilize Microsoft Dynamics 365 Business Central for managing various business operations and data.

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 fields
• BC_List_Items: Fetches a list of entities with optional filtering and pagination
• BC_Get_Items_By_Field: Searches for entities based on a specific field value
• BC_Create_Item: Creates a new entity record in Business Central
• BC_Update_Item: Updates an existing entity record
• BC_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:

• Employees
• Customers
• Items
• Vendors
• SalesOrders
• Payments

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

1. Create API credentials for Business Central
2. Configure your Business Central environment and company information
3. 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 username
• BC_PASS: Your Business Central API password
• BC_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

Using uvx

Development

Requirements

• Python 3.10+
• Dependencies listed in requirements.txt and pyproject.toml

Local Development

1. Clone the repository
2. Create a virtual environment:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install development dependencies:

   pip install -e .
   

4. Create a .env file 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
   

5. 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 © 2025 sofias tech