Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ALM XPP MCP Find all references to SalesTable.insert and list impacted extensions."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
npx launcher for the ALM XPP Cloud MCP - a Dynamics 365 Finance & Operations AI agent exposing 90 tools over MCP.
Published in the official MCP registry as
io.github.alimbenhelal-pro/alm-xpp-mcp.
The server answers from a pre-built index of the standard D365 F&O codebase: 200K+ AOT objects, 1.3M+ code chunks, 25M+ cross-references and 24M+ label translations -- 392K label ids rendered across 74 languages.
A general model answers X++ questions from whatever it memorised during training. This server answers from a specific, versioned copy of the standard D365 codebase:
What it means in practice | |
A known release | The Cloud MCP answers from the release the server has indexed, not from yours. The one currently loaded is reported by |
Your own version | Indexing your environment's exact build is what the Local MCP is for: it runs next to your D365 SDK and indexes the |
Traceable | Every result carries the AOT object and model it came from, so you can open it in Visual Studio and check |
Your extensions | Point |
No training on your code | Your metadata is indexed per session and used to answer your calls. It is not used to train anything |
Three different MCP servers show up around D365 F&O. This README always calls them by these names:
Name | What it is | How you get it |
Cloud MCP | The hosted ALM XPP server: 90 tools over the indexed D365 codebase | this package -- |
Local MCP | Runs on your own dev machine, next to the D365 SDK: 121 tools, 36 of which write AOT files, compile X++, sync the database. It is also the only one that can index your exact platform build, by reading the | separate licensed component, contact alim@almxpp.com |
Environment MCP | Microsoft's own Dynamics 365 ERP MCP server, exposed by your F&O environment itself, serving live data | enabled inside D365FO, then connected directly from VS Code |
This npm package covers the Cloud MCP only. The Local MCP is licensed separately, and the Environment MCP is Microsoft's -- your client connects to it on its own.
An API token -- get one at the dashboard
Node.js >= 18, only if you use the npx launcher described further down
Related MCP server: MCP X++ Server
The Cloud MCP is a streamable HTTP MCP server at https://api.almxpp.com/mcp, authenticated with the
X-API-Key header. Any client that speaks HTTP connects to it directly -- no Node.js, no launcher.
Tool calls are served on
api.almxpp.comonly.almxpp.comandwww.almxpp.comhost the website; a JSON-RPC POST sent there is refused with a message naming the correct URL. Only the host changes -- your API key and headers stay the same.
.vscode/mcp.json{
"servers": {
"almxppmcp": {
"type": "http",
"url": "https://api.almxpp.com/mcp",
"headers": {
"X-API-Key": "YOUR_TOKEN"
}
}
}
}X-API-Key is the only required header. The others unlock the tools that need your own context --
without them those tools simply report that they are not configured.
Header | Unlocks |
| Required. Your API token. |
| Absolute path to your own extension / ISV metadata on the calling machine. Analysis tools read from here |
| Absolute path to |
| Azure DevOps organisation, e.g. |
| Azure DevOps project name. Required alongside |
| Azure DevOps token. Indexes your own X++ metadata from the repo and reads work items. |
| Repository holding the metadata, when the project has several |
| Branch to index, default |
| Folder inside the repo holding the AOT XML, default |
| Live environment base URL, for the |
| Entra tenant of that environment |
| Entra app registered in D365FO under Microsoft Entra applications |
| Secret of that app |
| Log Analytics workspace, for the |
| Entra tenant of that workspace |
| Entra app with Log Analytics Reader on the workspace |
| Secret of that app |
The live-environment and telemetry credentials can also be set for the session with
d365fo_set_connection and appinsights_set_connection, so they never sit in a config file.
examples/vscode-mcp.full-headers.json puts all of this together
and keeps every secret out of the file by prompting for it through VS Code inputs.
npx launcherSome clients only speak stdio. The almxppmcp command covers that case: it reads your token, sends it as
the X-API-Key header, and relays the traffic to the Cloud MCP over stdio. It has no dependencies --
just the one file, on top of what Node 18 already provides.
npx almxppmcp --api-key YOUR_TOKENor set the environment variable:
export ALMXPPMCP_API_KEY=YOUR_TOKEN
npx almxppmcp
--api-keyandALMXPPMCP_API_KEYare the two ways of giving the token to the launcher. Either way it ends up on the wire as the HTTP headerX-API-Key-- same token, different layer.
.vscode/mcp.json{
"servers": {
"almxppmcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "almxppmcp", "--api-key", "YOUR_TOKEN"]
}
}
}.cursor/mcp.json{
"mcpServers": {
"almxppmcp": {
"command": "npx",
"args": ["-y", "almxppmcp", "--api-key", "YOUR_TOKEN"]
}
}
}claude_desktop_config.json{
"mcpServers": {
"almxppmcp": {
"command": "npx",
"args": ["-y", "almxppmcp", "--api-key", "YOUR_TOKEN"]
}
}
}Tip: replace
YOUR_TOKENwith the token shown on your dashboard. Set it as an env var to avoid hard-coding it (root key ismcpServersfor Cursor and Claude Desktop,serversfor VS Code):{ "mcpServers": { "almxppmcp": { "command": "npx", "args": ["-y", "almxppmcp"], "env": { "ALMXPPMCP_API_KEY": "YOUR_TOKEN" } } } }
Variable | Description |
| Your API token (alternative to |
| Override the MCP endpoint (default: |
The Cloud MCP exposes 90 tools across 14 categories, listed below.
The Local MCP carries the 85 of them that do not depend on the cloud index, plus 36 more that must run next to your D365 environment (build, deploy, database sync, workspace writes) -- 121 tools on that side. Across both servers the toolbox is 126 distinct tools.
Category | Tools | Names |
Search | 5 |
|
Retrieve | 6 |
|
Relations & Impact | 11 |
|
Quality & Analysis | 7 |
|
Security & Licensing | 4 |
|
Code Generation | 8 |
|
Functional Domain | 2 |
|
Differentiators | 2 |
|
Upgrade & Release Notes | 6 |
|
Live Environment | 5 |
|
Data Migration | 7 |
|
Performance Diagnostics | 4 |
|
Orchestration & Reporting | 6 |
|
Azure DevOps | 17 |
|
Beyond code search, the notable capabilities are:
Upgrade impact - compare two D365 versions against your own customisations and produce the regression report as Word and PowerPoint.
Live environment - connect to a running environment, read and write real records over OData, run Data Management projects.
Performance diagnostics - query Application Insights telemetry and get a ranked diagnosis of what is actually slow.
Azure DevOps - work items, pull requests, wiki, from analysis to review.
Full reference with parameters and example prompts: https://www.almxpp.com/docs
This repository holds the client side only — the npx launcher published to
npm as almxppmcp:
Path | Purpose |
| Resolves the API key and server URL, then bridges your client's stdio to the Cloud MCP over HTTP -- no third-party package involved |
| MCP registry manifest |
The Cloud MCP itself — index, retrieval, the 90 tools and the licensing layer — is
closed source and runs at https://api.almxpp.com/mcp. The launcher never sees
your code: it forwards requests over HTTPS with the token you provide.
MIT
This server cannot be deployed
Change-impact intelligence for tracing dependencies, stale references and required updates.
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.
Enterprise code intelligence for M&A, security audits, and tech debt. Hosted server with 200k free.
