ALM X++ MCP Server — Claude Code MCP server: setup and tools
ALM X++ MCP Server is a Claude Code MCP server that connects to indexed Dynamics 365 F&O metadata through 90 tools. It queries AOT objects, cross-references, and labels in real time.
MIT ★ 5 updated 2026-09-04
claude mcp add --transport http alm-xpp-mcp https://api.almxpp.com/mcpWhat ALM X++ MCP Server does
The server searches an index of the standard D365 F&O codebase. It indexes over 200K AOT objects, 25M cross-references, and 24M label translations across 74 languages. Each response returns the exact AOT object name and source model.
Running tool calls requires an API token from almxpp.com passed via the X-API-Key header. To query custom extensions, you supply a local path in D365-Custom-Model-Path or connect Azure DevOps repository details with a PAT token. User code is indexed per session without being used for model training.
This cloud package reads indexed metadata and does not compile local X++ binaries on your dev environment. Optional connection headers enable telemetry queries in Application Insights and data entity calls through live D365FO endpoints.
What it helps with
- search standard AOT objects across D365 F&O models
- inspect label translations across 74 languages
- index custom extensions from an Azure DevOps repository
- query live telemetry through Application Insights
Example prompts for the agent
- Find all references to CustTable in standard D365 models
- Look up the translation for label @SYS12345 in German and French
- Search for method definitions in the SalesTableType class
How to install ALM X++ MCP Server
1Platform CLI: remote server
claude mcp add --transport http alm-xpp-mcp https://api.almxpp.com/mcp2Platform CLI
claude mcp add --env ALMXPPMCP_API_KEY=<ALMXPPMCP_API_KEY> --transport stdio alm-x-mcp-server -- npx -y almxppmcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add alm-x-mcp-server --url https://api.almxpp.com/mcp2Platform CLI
codex mcp add alm-x-mcp-server --env ALMXPPMCP_API_KEY=<ALMXPPMCP_API_KEY> -- npx -y almxppmcpReplace <…> with your own values
Config file
{
"mcpServers": {
"alm-x-mcp-server": {
"url": "https://api.almxpp.com/mcp"
}
}
}{
"mcpServers": {
"alm-x-mcp-server": {
"command": "npx",
"args": [
"-y",
"almxppmcp"
],
"env": {
"ALMXPPMCP_API_KEY": "<ALMXPPMCP_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"alm-x-mcp-server": {
"type": "http",
"url": "https://api.almxpp.com/mcp"
}
}
}{
"servers": {
"alm-x-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"almxppmcp"
],
"env": {
"ALMXPPMCP_API_KEY": "<ALMXPPMCP_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http alm-x-mcp-server https://api.almxpp.com/mcp2Platform CLI
gemini mcp add -e ALMXPPMCP_API_KEY=<ALMXPPMCP_API_KEY> alm-x-mcp-server npx -y almxppmcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ALM X++ MCP Server
How to install ALM X++ MCP Server in Claude Code?
Run claude mcp add --transport http alm-xpp-mcp https://api.almxpp.com/mcp in your terminal.
What does ALM X++ MCP Server do?
It provides 90 tools for inspecting Dynamics 365 Finance & Operations code, querying indexed AOT objects, cross-references, and UI labels.
What is required to run ALM X++ MCP Server?
You need an API key generated in the almxpp.com dashboard. Running via npx additionally requires Node.js version 18 or newer.