1. Home
  2. Business Central integration
  3. Business Central MCP

Business Central MCP: Microsoft's server reads by default, and admins allow the rest

Yes: Microsoft runs an official MCP server for Business Central online, in public preview from October 31, 2025 and generally available, as the enhanced server, from April 1, 2026. Out of the box it only reads what the signed-in user may see, and an admin must allow each write.

Checked 19 November 2026

Yes: Microsoft runs an official Business Central MCP server

MCP is the protocol an AI client uses to call Business Central’s API pages as tools. Business Central’s server is Microsoft’s own. Every client, from Copilot Studio to Claude, uses the same address: https://mcp.businesscentral.dynamics.com. Microsoft’s pages say it is for Business Central online.

Here is how its status moved, from Microsoft’s release plans and update notes:

Scroll the table sideways to see every column.

Date or version What Microsoft lists
October 31, 2025 Public preview of the MCP server, with no general availability date given
April 1, 2026 The enhanced server generally available, with OAuth 2.1 and telemetry
Version 28.0, 2026 release wave 1 Enhanced server listed as generally available, now from Visual Studio Code and other clients
June 12, 2026 All standard Microsoft APIs and API queries generally available through the server
Version 29.0, 2026 release wave 2 “Run data queries with MCP Server” listed as generally available

Microsoft archived these release plans in October 2026, so the table is their last word.

Microsoft’s pages disagree on data queries. The 29.0 notes call them generally available. Three other Microsoft pages still mark them preview: the setup page, last updated October 2, 2026, says the feature “is currently in preview”. The overview, last updated November 11, 2026, writes “Data Query Tools (Preview)”, and so does the Copilot Studio page of October 2, 2026. Treat it as preview until those pages change.

The default setup only reads

With no setup at all, the server’s built-in configuration lets an agent find and read API pages and API queries. It sees only those the signed-in user has permission to use. It cannot write. That is enough for questions such as “list my open sales orders”, asked from a chat window in Copilot Studio, Visual Studio Code or Claude.

To let an agent write, an admin builds a named setup, which Microsoft calls a configuration. The admin needs Microsoft’s MCP Admin permission set. The steps run on the MCP Server Configurations page:

  1. Name it. The name shows in Copilot Studio, and the built-in default has a blank name.
  2. Add API objects. Add All Standard APIs brings in the API v2.0 pages and queries. Add APIs by API Group brings in one published group.
  3. Set permissions per object. Allow Read, Allow Create, Allow Modify, Allow Delete and Allow Actions. API queries can only read.
  4. Turn on Unblock Edit Tools. Without it, no tool in the configuration can create, update, delete or run actions.
  5. Validate. The check flags API objects that no longer exist, missing parent API pages, and entries with Allow Modify on but Allow Read off.
  6. Activate. An active configuration is read-only, so switch it off before you change it.

You can export a configuration as JSON and import it in another environment. That lets you test a setup in a sandbox, then import the same file into production. Each configuration also has a connection string, a block of JSON you paste into a client such as Visual Studio Code.

One limit and one power catch people out. ListPart and CardPart API pages aren’t currently supported; only top-level API pages can be tools. And with Allow Actions on, an agent can post documents or change statuses through API page actions or API codeunit actions.

Server features: API tools, dynamic mode, data queries

Each configuration switches on server features one by one:

  • API Tools. The admin picks which API pages and API queries agents can reach.
  • Dynamic Tool Mode. Agents find tools at run time instead of each one being added by hand. Microsoft points to Copilot Studio’s 70-tool limit as a reason to use it.
  • Discover Read-Only Objects. Off by default in a configuration you create. The built-in default configuration has it on. When on, agents can also read eligible API pages and queries that you did not add as tools.
  • Data Query Tools. Agents read the database straight, through 4 tools. They can find tables, read a table’s fields, see how tables link, and run a query. The last tool, bc_data_query, checks an AL query first. It runs it only when returnData is true.

Tool names come from the API page

With dynamic mode off, each permission becomes a tool with its own name. Microsoft’s example is page 30009, the customers API. Tick all four record boxes and you get four tools, from List_Customers_PAG30009 to Delete_Customer_PAG30009. The end of the name tells you the kind of object. PAG is a page, QRY a query and COD a codeunit.

With dynamic mode on, the agent sees three system tools instead: bc_actions_search, bc_actions_describe and bc_actions_invoke. It searches for the action it needs, reads its shape, then calls it. To see which API pages an environment has, Microsoft suggests the Page Metadata virtual table, ID 2000000138.

Sign-in uses OAuth with PKCE and runs as the user

The server follows the MCP sign-in rules: the OAuth 2.0 Authorization Code flow with PKCE, an added check on the sign-in code, with Microsoft Entra ID as the sign-in service. Every call runs with the user’s own identity and permissions. So the audit trail shows which user did each action.

Microsoft’s own clients skip app setup. Visual Studio Code and Copilot Studio use an app Microsoft registered in advance. Any other client needs its own app in Microsoft Entra ID:

  • Who registers it. A user with the Application Developer role. A tenant admin then grants consent.
  • Rights. Financials.ReadWrite.All, as a delegated right for Business Central.
  • Redirect address. The client’s own. For Claude Code it is http://localhost:<port>/callback.
  • Why it is manual. MCP allows clients to register themselves, but Microsoft Entra ID does not support that.
  • Transport. Streamable HTTP only. The older HTTP/SSE transport is not supported.

One app registration can serve several clients.

Four headers tell the server where to work

Each connection says where to work, in up to four headers. They are TenantId, EnvironmentName, Company and ConfigurationName. The last is optional. Leave it out and the server uses the current default. A company name with letters such as ø or å must be sent in Base64, a safe text code.

Clients differ in what they can leave out, and Microsoft’s pages do not agree on two of them:

Scroll the table sideways to see every column.

Client What it may omit
Visual Studio Code with GitHub Copilot All four headers
GitHub Copilot CLI The overview (November 11, 2026) says all three can be left out; the hosts page (October 2, 2026) says EnvironmentName is needed
Copilot Studio The overview says all three are required for now; the Copilot Studio page (October 2, 2026) says the tenant comes from the sign-in
Other clients Depends on the client

Microsoft’s overview, the newer page, marks Copilot Studio as needing all three headers for now and says headerless setup is coming soon. Test your own client before you rely on either rule.

Before it connects, a client can call GET /$configurations. It gets back the live setups for its tenant.

Copilot Studio offers the MCP server and a connector

Copilot Studio offers two ways in. The Business Central MCP server gives an agent tools built from your configuration. The Business Central connector for Power Platform gives set actions, such as Find records (V3) and Create record (V3). Both act with the signed-in user’s permissions, and one agent can use both. After you change a configuration, refresh the tools in Copilot Studio, or the agent keeps the old list.

Microsoft plans to charge for the tools

Microsoft’s overview, last updated November 11, 2026, says it plans to charge for Business Central MCP tools. Pricing, the tools affected and the rollout “will be shared in a future update”. So budget for a charge you cannot size yet. Business Central’s published license prices are in our Business Central pricing article.

Two other Business Central MCP servers do other jobs

Microsoft ships at least two more servers with MCP in the name. Neither replaces the one above.

  • Troubleshooting MCP Server for AL. For Business Central 2026 release wave 1 and later. It lets GitHub Copilot read the state of AL code during a debugging session, and it is only there while you debug.
  • Admin center MCP server. In public preview since April 1, 2026, with no date for full release. Admins ask it when updates are due, which upgrades exist and which apps are installed.

Community Business Central MCP servers are not Microsoft’s

Developers outside Microsoft also publish servers. Two examples, from their GitHub pages read on 19 November 2026:

  • knowall-ai/mcp-business-central calls API v2.0 directly. It signs in with the Azure CLI, or with a client secret when no person is present.
  • MS-Cloud-Experts/mcp-business-central lists 115 named tools. They cover 93 kinds of record. It signs in through the Azure CLI.

These run outside Microsoft’s configurations, so the Unblock Edit Tools switch and the per-object ticks do not apply. Their rights come from the account you give them. Read the code before you point one at a live company.

Test each configuration in a sandbox before production

Business Central gets two major updates a year, in April and October, and each major version has a five-month update window. The MCP server has changed in each of the last three waves. So test your configurations in a sandbox in each window, export them, and import the tested file into production.

An MCP client suits a person working in a chat. A job that starts when an order email or a supplier bill arrives needs an agent that runs without a prompt. Microsoft’s Sales Order Agent and Payables Agent are two such agents; Dynamics 365 AI agents sets out what they cover. The Dynamics 365 MCP page covers the servers for Finance, Supply Chain and Sales.

Our team has taken Dynamics 365 Business Central and Dynamics 365 Finance live.

Our team has delivered on-demand ERP modules, each built for one business problem.

The first call is free.

Questions

Does Business Central have an MCP server?

Yes. Microsoft runs it at mcp.businesscentral.dynamics.com, and every client connects to that one address. It covers Business Central online. Microsoft's release plan put it in public preview on October 31, 2025, and lists the enhanced server as generally available from April 1, 2026. It turns API pages and API queries into tools that an AI client can call.

Is the Business Central MCP server free?

For now Microsoft lists no charge for the server itself. Its overview, last updated November 11, 2026, says Microsoft plans to charge for Business Central MCP tools, with pricing, affected tools and rollout to come in a future update. The AI client is a separate bill. In Copilot Studio, the agent maker needs a user license with Copilot Credits capacity.

Can Claude connect to Business Central?

Yes. Microsoft names Claude, ChatGPT and MCP Inspector as clients that can connect. Because Claude is not a Microsoft client, you first register an app in Microsoft Entra ID. Give it the delegated Financials.ReadWrite.All permission and Claude Code's redirect address, and have a tenant admin grant consent. Entra does not support automatic client registration, so this step cannot be skipped.

Can the MCP server post documents in Business Central?

Yes, once an admin allows it. The default setup only reads. An admin adds API pages to a configuration, turns on Unblock Edit Tools and ticks Allow Actions. The agent can then run actions such as posting a document or changing a status. Each call still runs with the signed-in user's own permissions, so the audit trail shows who did it.

Does the MCP server work with Business Central on-premises?

No, on the pages we read. Microsoft's MCP overview says it applies to Business Central online, and so do its setup page and its page for clients from other vendors. For an on-premises system, an agent has to use the APIs you publish yourself, or a custom server. The separate troubleshooting server for AL code runs only inside a debugging session in Visual Studio Code.

Why can't my agent see a Business Central tool?

Check four things. The signed-in user needs access to the environment and the company. The user needs permission for the API object behind the tool. The right configuration must be picked, or set as the default. And after any change to a configuration, refresh the tools in Copilot Studio. ListPart and CardPart API pages aren't currently supported, because only top-level API pages can be tools.

Sources

Every source behind a figure or a vendor fact on this page, with the day we read it.

Decide what your Business Central agent may change

Bring the jobs you want an AI client to do in Business Central and the API pages they touch. On the first call we talk through which permissions each job needs and which should stay off. The first call is free.

Book a Business Central call