From 103ce14426b74ed864e07c69f0953e3d57b984dc Mon Sep 17 00:00:00 2001
From: Jeremy Vyska <jeremy@sparebrained.com>
Date: Fri, 17 Oct 2025 09:22:35 +0200
Subject: [PATCH] Add NAB AL Tools MCP server to Tools list

---
 .../CommunityResources/Tools/_index.md        |  9 +++
 .../Tools/nab-al-tools-mcp.md                 | 79 +++++++++++++++++++
 2 files changed, 88 insertions(+)
 create mode 100644 content/docs/agentic-coding/CommunityResources/Tools/nab-al-tools-mcp.md

diff --git a/content/docs/agentic-coding/CommunityResources/Tools/_index.md b/content/docs/agentic-coding/CommunityResources/Tools/_index.md
index f0fbd82c..9f334a79 100644
--- a/content/docs/agentic-coding/CommunityResources/Tools/_index.md
+++ b/content/docs/agentic-coding/CommunityResources/Tools/_index.md
@@ -93,6 +93,15 @@ Each MCP server below has its own dedicated page with detailed information, setu
 
 ---
 
+### [NAB AL Tools MCP](nab-al-tools-mcp.md)
+
+**Key Features**:
+- XLIFF/XLF translation tooling exposed as MCP tools
+- Rich validation and annotations (Zod schemas)
+- Multiple invocation options (npx, global, local)
+
+---
+
 ## Contributing Tools
 
 **Created a tool for AI-assisted AL development?**
diff --git a/content/docs/agentic-coding/CommunityResources/Tools/nab-al-tools-mcp.md b/content/docs/agentic-coding/CommunityResources/Tools/nab-al-tools-mcp.md
new file mode 100644
index 00000000..3faa97bb
--- /dev/null
+++ b/content/docs/agentic-coding/CommunityResources/Tools/nab-al-tools-mcp.md
@@ -0,0 +1,79 @@
+---
+title: "NAB AL Tools MCP"
+linkTitle: "NAB AL Tools"
+weight: 8
+description: >
+  XLIFF translation and localization tools exposed as an MCP server for AL projects.
+---
+
+## Overview
+
+The NAB AL Tools MCP Server exposes XLIFF translation management capabilities (the same core features used by the NAB AL Tools VS Code extension) as a standalone MCP server. It lets AI assistants and other MCP-compatible clients inspect, create, refresh and save XLF files used for AL localization workflows.
+
+**Publisher**: [nabsolutions / jwikman](https://github.com/jwikman)
+
+---
+
+## Key Features
+
+- Comprehensive XLF/XLIFF tooling: refresh, create language XLFs, search by keyword, get untranslated texts, and more
+- Proper MCP annotations and Zod input validation for robust error handling
+- Configurable: works with npx, global install, or local project install
+- Supports pagination, batch saves and performant parsing for large translation files
+- Designed to work locally (openWorldHint: false) and respects workspace boundaries
+
+---
+
+## Installation & Usage
+
+Recommended via npx (no install required):
+
+```bash
+npx -y @nabsolutions/nab-al-tools-mcp
+```
+
+Or install globally:
+
+```bash
+npm install -g @nabsolutions/nab-al-tools-mcp
+```
+
+MCP client example (npx):
+
+```json
+{
+  "mcpServers": {
+    "nab-al-tools": {
+      "command": "npx",
+      "args": ["-y", "@nabsolutions/nab-al-tools-mcp"]
+    }
+  }
+}
+```
+
+---
+
+## Notable Tools (summary)
+
+- `refreshXlf` — synchronize generated .g.xlf with target XLF
+- `getTextsToTranslate` — list untranslated units with pagination
+- `getTranslatedTextsMap` — fetch existing translations grouped by source
+- `getTranslatedTextsByState` — filter translations by state (needs-review, translated, final)
+- `saveTranslatedTexts` — batch save translated units (up to configured limits)
+- `createLanguageXlf` — generate new language XLFs (can optionally match base app translations)
+- `getTextsByKeyword` — search XLF content by keyword or regex
+- `getGlossaryTerms` — return builtin BC glossary pairs for consistent terminology
+
+---
+
+## Requirements
+
+- Node.js >= 20
+- npm (if installing)
+
+---
+
+## Links
+
+- **GitHub**: https://github.com/jwikman/nab-al-tools
+- **MCP readme (source)**: https://github.com/jwikman/nab-al-tools/blob/main/extension/MCP_SERVER.md