# ALM XPP MCP — D365 F&O AI Agent

> MCP server for Microsoft Dynamics 365 Finance & Operations with 1,300,000+ indexed X++ objects.
> Endpoint: [https://www.almxpp.com/mcp](https://www.almxpp.com/mcp) | Docs: [https://www.almxpp.com/docs](https://www.almxpp.com/docs) | Auth: X-API-Key header

## What this server does

Provides 90 AI tools for D365 F&O developers:
- Search 200K+ X++ objects (tables, classes, forms, enums, EDT, queries, security)
- 25M+ cross-references and 392K+ labels in every supported language
- Generate CoC extensions, data entities, reports, security chains from live metadata
- Analyse Azure DevOps work items, PRs, sprint capacity, code review
- Trace security chains (Role->Duty->Privilege->EntryPoint), field lineage, change impact
- Evaluate best-practice violations and auto-generate X++ fix patches
- Compare D365 versions for upgrade impact (release notes, regression risks)

## Quick Start (MCP config)

  {
    "servers": {
      "almxppmcp": {
        "url": "https://www.almxpp.com/mcp",
        "headers": { "X-API-Key": "mcp-<your-token>" }
      }
    }
  }

## Key Tools

- search_d365_code(query) -- semantic search over 200K+ D365 objects (BGE-M3 + BM25 + sparse)
- get_object_details(name) -- full source, fields, methods, relations for any AOT object
- get_object_context(name) -- combined context (structure + extensions + validation) in 1 call
- find_extensions(name) -- all CoC / event handlers for an object
- generate_xpp_template(type, object) -- CoC, event handler, job, find method
- ado_analyze_workitem(id) -- deep work item analysis with KB cross-reference
- ado_review_xpp_pr(prId) -- AI-powered X++ code review
- trace_security_chain(name) -- full Role->Duty->Privilege->EntryPoint chain
- trace_field_lineage(table, field) -- data origin, readers, forms, reports
- fix_best_practice_violations(name) -- BP violations + optional X++ patches
- healthcheck() -- server status + search pipeline tiers + index stats

## Authentication

Get your API key at [https://www.almxpp.com/account/dashboard](https://www.almxpp.com/account/dashboard).
Pass as header: X-API-Key: mcp-<token>  or  Authorization: Bearer mcp-<token>

## Rate Limits & Plans

Trial: 100 credits/month. Developer: 2000/mo. Enterprise: unlimited.
Tool costs: search=2 credits, get_object_details=5, generate=10, ado=3.
See [pricing](https://www.almxpp.com/#pricing) for the current plans.

## npm / local install

  npx almxppmcp   # starts the local stdio server (requires D365 SDK on dev box)

The local server exposes 121 tools (126 distinct across both editions).

## Optional

- [Home](https://www.almxpp.com/) -- product overview
- [Documentation](https://www.almxpp.com/docs) -- every tool, parameter by parameter
- [Status](https://www.almxpp.com/status) -- live availability and index size
- [Security](https://www.almxpp.com/security) -- data handling and isolation model
- [OpenAPI](https://www.almxpp.com/openapi.json) -- machine-readable API description