MODX2MCP
AI-agent tools for MODX 2 with backups and dependency analysis
Creator: Alexander Palochkin (rumataestor)
About MODX2MCP
Connect AI agents to MODX Revolution 2.8.x using 192 MCP tools for content, elements, settings, access control, dependency analysis, safe updates and diagnostics. The manager dashboard and dependency graph support 9 languages: English, Russian, Spanish, German, French, Ukrainian, Kazakh (Cyrillic), Dutch and Polish. Requires Node.js 18+ MCP client.
Information
Released
November 21, 2026
Supported Database
MySQL
License
MIT
Instructions
Installation — MODX2MCP 1.2.7-pl-2
Requirements
- MODX Revolution 2.8.x
- MySQL or MariaDB
- Node.js 18+ on the machine running the MCP client
Installation
modx2mcp-1.2.7-pl-2.transport.zip package.Upgrading from Previous Versions
Normal upgrades of the existing MODX2MCP (modx2mcp) package preserve system settings and API tokens.
If upgrading from the older MODX MCP package (modxmcp) for MODX 2, note that it uses a different package identity.
Before migrating:
- Back up your existing settings and API token.
- Verify which package is currently installed.
- Follow the migration procedure for the legacy package.
- Do not uninstall the old package without a recovery plan.
Compatibility
MODX2MCP supports MODX Revolution 2.8.x.
The shared MCP client supports both MODX 2 and MODX 3, but each platform requires its own transport package.
Do not install the MODX 3 transport package on MODX 2.
After Installation
Documentation
Full documentation and release notes:
https://github.com/rumata-estor/modx3-mcp
Release: v1.2.7
New in 1.2.7-pl2
MODX2MCP 1.2.7-pl-2 — Changes since 1.2.4-pl
Stable release for MODX Revolution 2.8.x.
CAS v2 Compatibility
- Fixed inconsistent CAS version reporting between
get_capabilitiesandgetSiteState. - Improved compatibility with atomic preconditions and protected Template Variable updates.
- Preserved existing permission checks and security safeguards.
Category Management
- Added extended management of MODX element categories (
modCategory). - List, create, rename, move, reorder, and safely delete categories.
- Assign categories to elements without rewriting their content.
- Added dependency checks to prevent unsafe deletion.
Compatibility and Stability
- Maintained 199 server actions and 198 public MCP tools.
- Preserved existing settings and API tokens during normal upgrades.
- Maintained compatibility with MODX Revolution 2.8.x.
- Updated documentation in nine languages.
Version Numbering
Two version numbers were skipped between stable releases:
- 1.2.5 was prepared but not released as a completed stable version.
- 1.2.6-test was used for preliminary testing and was not promoted to a stable release.
- 1.2.7 is the next stable version following 1.2.4.
Experimental changes from PR #40 and PR #46 were not included in this stable release.
Package Publication
The 1.2.7-pl-2 release index resolves a transport-package filename conflict in MODX Extras.
This publication contains the MODX Revolution 2.x transport package. Component functionality remains unchanged from stable version 1.2.7.
Documentation
https://github.com/rumata-estor/modx3-mcp/releases/tag/v1.2.7