# ALM X++ MCP Server

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: alimbenhelal-pro
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alimbenhelal-pro/ALM-XPP-MCP
- Updated: 2026-09-04
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/alm-x-mcp-server

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.almxpp.com/mcp`
- Environment variables: `ALMXPPMCP_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http alm-xpp-mcp https://api.almxpp.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env ALMXPPMCP_API_KEY=<ALMXPPMCP_API_KEY> --transport stdio alm-x-mcp-server -- npx -y almxppmcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add alm-x-mcp-server --url https://api.almxpp.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add alm-x-mcp-server --env ALMXPPMCP_API_KEY=<ALMXPPMCP_API_KEY> -- npx -y almxppmcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alm-x-mcp-server": {
            "url": "https://api.almxpp.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alm-x-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "almxppmcp"
            ],
            "env": {
                "ALMXPPMCP_API_KEY": "<ALMXPPMCP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "alm-x-mcp-server": {
            "type": "http",
            "url": "https://api.almxpp.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "alm-x-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "almxppmcp"
            ],
            "env": {
                "ALMXPPMCP_API_KEY": "<ALMXPPMCP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http alm-x-mcp-server https://api.almxpp.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e ALMXPPMCP_API_KEY=<ALMXPPMCP_API_KEY> alm-x-mcp-server npx -y almxppmcp
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [D365FO MCP Server](https://affpapa.org/en/nevibecode/mcp/d365fo-mcp-server.md) — MCP server · ★ 42 repo stars
- [d365fo-connector](https://affpapa.org/en/nevibecode/mcp/d365fo-connector.md) — MCP server · ★ 10 repo stars
- [business-central-development](https://affpapa.org/en/nevibecode/skills/business-central-development.md) — skill · 802 installs
- [d365-solution-blueprint](https://affpapa.org/en/nevibecode/skills/d365-solution-blueprint.md) — skill · 13 installs
- [Dynamics 365 Business Central Admin](https://affpapa.org/en/nevibecode/mcp/dynamics-365-business-central-admin.md) — MCP server · ★ 13 repo stars
- [dataverse](https://affpapa.org/en/nevibecode/plugins/dataverse.md) — plugin · ★ 262 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
