business-central-mcp

An MCP server that speaks BC's native WebSocket protocol, giving AI assistants direct access to pages, data, actions, reports, and multi-company switching.

View source

Stack: TypeScript · Node.js
Status: Active
Released: 2025
License: MIT

Overview

MCP server for Microsoft Dynamics 365 Business Central. Speaks BC’s undocumented WebSocket protocol directly, the same one the browser-based web client uses. No OData, no SOAP, no browser automation.

11 tools covering page navigation, data reads/writes, action execution, dialog handling, report execution, and multi-company switching. Protocol reverse-engineered from 26 decompiled BC28 server assemblies.

Session resilience with exponential backoff, invoke timeouts, license auto-dismiss, and modal state recovery. 128 unit tests, 103 integration tests against live BC27/BC28.

Install via npx business-central-mcp. BC27 and BC28 supported (wire-compatible). NavUserPassword authentication.

Highlights

11 MCP tools for pages, data, actions, reports

Native BC WebSocket protocol, no OData or SOAP

Multi-company switching and Tell Me page discovery

Session resilience with exponential backoff

BC27 and BC28 support (wire-compatible)

128 unit tests, 103 integration tests on live BC