- Home
- Dynamics 365 integration
- Dynamics 365 MCP
Dynamics 365 MCP: Microsoft runs a separate server for each app family
There is no single Dynamics 365 MCP server. Finance and Supply Chain use the ERP MCP server, version 10.0.47 or later, and Sales uses the Dataverse server plus a Sales server with 20 tools. Business Central has its own, and each ERP server call runs with a signed-in identity's rights, never more.
Dynamics 365 has one MCP server per app family
MCP is the protocol Microsoft uses to let an AI client call Dynamics 365 tools. Dynamics 365 is a family of apps, and Microsoft gives each family its own MCP server. Start with the app you run.
Scroll the table sideways to see every column.
| App you run | Microsoft’s MCP server | Where it lives |
|---|---|---|
| Finance, Supply Chain Management | Dynamics 365 ERP MCP server | Inside your finance and operations environment |
| Sales, Customer Service | Dataverse MCP server | https://{dataverseOrgName}.crm.dynamics.com/api/mcp |
| Sales, for seller skills | Dynamics 365 Sales MCP server | Behind Microsoft’s Agent 365 Tooling Gateway |
| Business Central | Business Central MCP server | mcp.businesscentral.dynamics.com |
Sales and Customer Service sit on Dataverse, Microsoft’s data platform, which is why they share its server. None of the pages we read on 19 November 2026 calls the ERP, Dataverse or Sales server itself a preview, and none gives a date for general availability. Two parts are marked preview: file output on the ERP server, and the AI tool framework your developers use to build action tools. Microsoft’s gateway page also marks Work IQ, a second route to the Sales tools, as preview.
The ERP MCP server needs version 10.0.47 and Tier 2
The ERP MCP server covers Finance and Supply Chain Management. Microsoft calls them finance and operations apps. Microsoft says agents can use it for “nearly any function” a user can reach in the app, with no custom code, connectors or APIs.
Check four things before you plan an agent on it:
- Version. At least 10.0.47, 10.0.46 PQU-2 or 10.0.45 PQU-7.
- Feature switch. The server is on by default. If it is off, turn on the Dynamics 365 ERP Model Context Protocol server feature in Feature Management.
- Allowed client. Your agent platform must be listed on the Allowed MCP Clients page.
- Environment. Tier 2 or higher, or a Unified Developer Environment. Cloud Hosted Environments are not supported.
The old static ERP server’s end date has passed
An earlier version, the static server, had 13 fixed tools and was built on the Dataverse connector framework. Microsoft’s ERP MCP page, last updated August 19, 2026, says this static server “will be retired on October 1, 2026”. The same note says it is still available in environments on version 10.0.2263.17 and greater. On 19 November 2026 the page still reads that way, and October 1 has passed. We could not confirm from Microsoft whether the static server is switched off. Plan every new agent on the dynamic server.
22 tools in three groups: data, form and action
We counted 22 tools in Microsoft’s tables on 19 November 2026: 7 data tools, 13 form tools and 2 action tools. Two of the data tools are versions of one: from 10.0.48 the SQL find tool replaces the OData one. Each group reaches the app in a different way.
Scroll the table sideways to see every column.
| Group | What it does | Tools to know |
|---|---|---|
| Data (7) | Create, read, update and delete records through data entities | data_find_entities_sql, data_create_entities, data_delete_entities |
| Form (13) | Open forms, set fields and press buttons, as a person would | form_open_menu_item, form_set_control_values, form_click_control |
| Action (2) | Find and run code your developers expose as AI tools | api_find_actions, api_invoke_action |
Microsoft gives three rules for choosing between them:
- Data tools first. They are faster for standard record work and need fewer tool calls than form tools. Deep inserts are not supported on create.
- Form tools for the rest. They reach buttons and values the app works out on the fly. They run through server APIs, not a live client session.
- Action tools for your own logic. A developer writes a class with the AI tool framework, using the ICustomAPI interface, and the agent finds it with api_find_actions. Microsoft marks that framework as a preview, not meant for production use, and it needs the preview Custom API Generation feature.
The tool list for an agent also shrinks to its role. An agent with the Purchasing Agent role sees only the objects in that role’s duties and privileges.
What the ERP MCP server cannot do yet
Microsoft lists these limits on the same page:
- US English only. Labels and values follow the user’s locale, but the server’s own guidance stays in English.
- Some controls are out. Calendar, organization chart, list view, availability view, HTML editor, image, radio button and time edit controls, and any custom control.
- One grid filter. Only “matches”. Before, after and between on dates do not work.
- No admin forms. Feature management, user management and security forms are closed to agents.
- Down during servicing. Requests in a servicing window fail, so plan retries.
Files: 160 KB inline, 5 MB as a resource, 15 MB uploads
Inline replies top out at roughly 160 KB. Set returnAsResource to true and a query result can reach 5 MB. This output path is a preview and needs version 10.0.48 or later.
Uploads work differently. Microsoft’s attach flow runs only in Copilot Studio, because it uses the Dataverse connector. Other clients can call the attach API through another integration. The largest attachment is 15 MB. Downloads stop at 5 MB per file, with a 60-second timeout. The attach API does not check for duplicates, so call McpIsFileAlreadyAttachedToRecord first.
Every call runs with a signed-in identity’s rights
The ERP server has no anonymous path. Every request needs an authenticated user, and an autonomous agent gets an identity of its own. Microsoft says the server “doesn’t elevate privilege”. Your security roles, with their duties and privileges, apply to each call.
Five clients can connect by default. They are Copilot Studio, Visual Studio Code, Microsoft Cowork, Finance Agent and Finance Agent (Sydney). For any other client, register an app in Microsoft Entra ID, add its client ID to the Allowed MCP clients form and set Allowed to true.
Two more rules help a security review. The server goes through OData, custom services and server APIs, never straight to the database, so validations and workflows still run. It also stores no customer data. What the agent client keeps is up to that client, so check its retention rules too.
An agent identity needs no Finance user license
Microsoft says an agent’s identity needs no finance and operations user license if it is built in Copilot Studio or works through an ERP MCP server. Assign it the System agent role, which carries no permissions, then add the roles its job needs. People who chat with the agent still need a Dynamics 365 license.
Outside Copilot Studio, tool calls are billed apart from the model. In Copilot Studio, one fixed rate per tool call covers both. Any other client pays its own model bill plus Copilot Credits for its tool calls to the server. Finance Premium and Supply Chain Management Premium users skip that tool charge on clients other than Copilot Studio. Microsoft’s rates are in our Dynamics 365 cost article.
Sales and Customer Service use the Dataverse MCP server
The Dataverse server’s address is your org name plus .crm.dynamics.com/api/mcp. It is not on until an admin enables it and sets its allowed clients for the Power Platform environment. Microsoft names Copilot Studio agents, GitHub Copilot in Visual Studio Code, GitHub Copilot CLI, Claude desktop and Claude Code as clients.
We counted 16 tools on Microsoft’s page, last updated November 13, 2026. Three matter most for a CRM agent:
- read_query runs supported Dataverse SQL SELECT queries.
- create_record and update_record write rows.
- delete_record deletes a row “only after explicit user approval”.
Microsoft also renamed tools. describe_table, list_tables and fetch are gone, replaced by describe, and the old data search tool is now search_data. If your client has an allow list by tool name, update it. Billing differs by tool: search_data is billed by usage, while the others share a basic rate.
The Sales MCP server adds 20 seller tools
The Sales server brings tools from two of Microsoft’s sales agents and from Copilot in Sales. We counted 20 in Microsoft’s table, such as get_lead_research, draft_outreach_email and get_opportunity_top_risks.
Microsoft’s two Sales pages, both last updated July 17, 2026, differ on record work. The overview says the Sales server also supports tools for create, read, update and delete on Dataverse records. The connect page says to connect the Dataverse server as well for that work. Follow the connect page. Add both.
Microsoft’s newer gateway page, last updated September 25, 2026, puts the Sales server behind the Agent 365 Tooling Gateway, which handles the sign-in to Dataverse. It names Visual Studio Code, GitHub Copilot CLI, Cursor, ChatGPT and Claude Code as clients that set up sign-in on their own. The older Sales connect page, of July 17, 2026, says Claude Desktop is not supported.
Plan three admin steps:
- Consent first. The gateway scope does not allow consent user by user, so a tenant admin approves it in advance.
- Mind the boundary. Microsoft warns that turning it on lets data leave the FedRAMP High boundary.
- Get the path right. Leave out
/mcp/environments/and the call returns 404 RouteNotFound.
Business Central has its own MCP server
Business Central’s MCP server is neither the ERP server nor the Dataverse server. It sits at mcp.businesscentral.dynamics.com, with its own tool settings and sign-in rules. Our Business Central MCP server page covers it.
Community Dynamics 365 MCP servers are not Microsoft’s
Developers outside Microsoft publish their own servers on GitHub. One example, read on 19 November 2026, is mafzaal/d365fo-client. It is a Python library and MCP server for Finance and Operations under the MIT license. Its page lists 49 tools in 9 categories and three transports: stdio, HTTP and Server-Sent Events.
A server like this reaches OData endpoints with credentials you give it. It does not go through the ERP MCP server, so the Allowed MCP clients list does not apply to it. Read the code and know who maintains it before you connect it to a live company.
When MCP is enough and when a job needs an agent
A chat client fits a person asking questions or making a one-off change. A job that starts when an email or a file lands needs an agent that runs on its own. On the ERP server, Microsoft gives such an agent an identity of its own, as above. For Microsoft’s own Finance and Business Central agents, and the jobs they leave uncovered, see Dynamics 365 AI agents. For the idea behind MCP, read what an MCP server is.
Our team has taken Dynamics 365 Business Central and Dynamics 365 Finance live.
The first call is free.
Questions
Does Dynamics 365 have an MCP server?
Yes, more than one. Finance and Supply Chain Management have the Dynamics 365 ERP MCP server, which runs inside your environment. Sales and Customer Service run on Dataverse, and Dataverse has its own MCP server at your org's address ending in /api/mcp. Sales also has a server with seller tools. Business Central has a separate server at mcp.businesscentral.dynamics.com. Pick the one that matches the app you run.
Is the static Dynamics 365 ERP MCP server still available?
We could not confirm it. Microsoft's ERP MCP page, last updated August 19, 2026, says the static server, with 13 tools, will be retired on October 1, 2026. That date has passed, and the page still uses the future tense. Microsoft tells users to move to the dynamic ERP MCP server. Build on the dynamic server and treat the static one as gone.
Can Claude or ChatGPT connect to Dynamics 365 through MCP?
It depends on the server. The ERP MCP server lets five Microsoft clients in by default. An admin adds any other client by registering it in Microsoft Entra ID and adding its client ID to the Allowed MCP clients form. Microsoft's Dataverse page names Claude desktop and Claude Code. Its Sales gateway page, of September 25, 2026, names ChatGPT, Cursor and Claude Code, while its Sales connect page, of July 17, 2026, says Claude Desktop is not supported.
Does an AI agent need its own Dynamics 365 Finance license?
Not today, if you set it up Microsoft's way. Microsoft says an agent identity needs no finance and operations user license when it is built in Copilot Studio or works through an ERP MCP server. Give it the System agent role, which grants nothing, then add the roles its job needs. People who chat with the agent still need their own Dynamics 365 license.
Can an AI agent delete records in Dynamics 365 through MCP?
Yes, if its role allows it. The ERP MCP server has a data_delete_entities tool, and it runs with the rights of the signed-in user. Microsoft says the server never raises those rights. On the Dataverse server, delete_record runs only after a person approves. So the role you give the agent is the real limit. Start with a narrow role.
What does a Dynamics 365 MCP tool call cost?
It depends on the client. Microsoft splits the bill into the model cost and the cost of tool calls to the ERP server. In Copilot Studio, both sit in one fixed rate per tool call. Other clients pay their own model bill plus a separate Copilot Credit charge for tool calls. Finance Premium and Supply Chain Management Premium skip that tool charge. Our Dynamics 365 cost article lists Microsoft's rates.
Sources
Every source behind a figure or a vendor fact on this page, with the day we read it.
- Microsoft Learn, Use Model Context Protocol for finance and operations appsRead 19 Nov 2026
- Microsoft Learn, Security for Dynamics 365 ERP MCPRead 19 Nov 2026
- Microsoft Learn, Files and attachments with Dynamics 365 ERP MCPRead 19 Nov 2026
- Microsoft Learn, Connect to Dataverse with model context protocol (MCP)Read 19 Nov 2026
- Microsoft Learn, Dynamics 365 Sales Model Context Protocol overviewRead 19 Nov 2026
- Microsoft Learn, Connect AI agents and assistants to Dynamics 365 Sales MCP ServerRead 19 Nov 2026
- Microsoft Learn, Connect the Sales MCP server through Agent 365 Tooling GatewayRead 19 Nov 2026
- Microsoft Learn, Business Central MCP server overviewRead 18 Nov 2026
- Microsoft Learn, Agents, Copilot and AI capabilities in Dynamics 365 appsRead 18 Nov 2026
- GitHub: mafzaal/d365fo-clientRead 19 Nov 2026
Pick the Dynamics 365 MCP server for your job
Bring the Dynamics 365 apps you run, their version numbers and the job you want an AI agent to do. On the first call we talk through which server fits and what its tools can reach. The first call is free.