MODX MCP
AI-agent tools for MODX 3 with backups and dependency analysis
Creator: Alexander Palochkin (rumataestor)
About MODX MCP
Connect AI agents to MODX Revolution 3.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 — MODX MCP 1.2.7
Requirements
- MODX Revolution 3.x
- PHP 8.1 or newer
- MySQL or MariaDB
- Node.js 18+ on the machine running the MCP client
Installation
modx3mcp-1.2.7-pl.transport.zip.MCP Client Configuration
Configure your MCP-compatible AI client using:
- API endpoint:
https://your-domain.com/assets/components/modxmcp/api.php - API token: generated during installation
- Node.js 18+ for the local MCP server
The same MCP client supports both MODX 2 and MODX 3, but the MODX transport packages are different.
Upgrading
Normal upgrades preserve existing modxmcp.* system settings and API tokens.
After upgrading, review the security configuration and confirm that the MCP connection works.
Important
This transport package is intended for MODX Revolution 3.x only.
Do not install the MODX2MCP transport package on MODX 3.
Documentation
Complete installation instructions, configuration examples and technical documentation are available in the GitHub repository:
rumata-estor/modx3-mcp
See docs/INSTALL.md and the v1.2.7 release documentation.
New in 1.2.7-pl2
MODX MCP 1.2.7-pl-2 — Changes since 1.2.4-pl
This is the corrected publication of MODX MCP 1.2.7 for MODX Revolution 3.x.
The release includes CAS v2 compatibility improvements, extended category management, and stability fixes.
CAS v2 Compatibility
- Fixed inconsistent CAS version reporting between
get_capabilitiesandget_site_state. - Both methods now report the actual supported precondition version.
- Fixed incorrect CAS v1 detection that could block protected Template Variable (TV) updates.
- Preserved atomic preconditions, permission checks, and existing security safeguards.
Category Management
- Added full management of MODX element categories (
modCategory). - Create, rename, move, reorder, and safely delete categories.
- Assign categories to templates, chunks, snippets, plugins, and template variables.
- Added dependency checks to prevent invalid operations and accidental deletion of occupied categories.
- Category assignments can be changed without rewriting element content.
Compatibility and Stability
- Maintained 199 server actions and 198 public MCP tools.
- Preserved existing system settings and API tokens during normal upgrades.
- Maintained compatibility with MODX Revolution 3.x.
- Updated documentation in 9 languages.
- Preserved existing MCP client compatibility and protected operations.
Version Numbering Explained
Versions 1.2.5 and 1.2.6 were used during development and testing.
- 1.2.5 was prepared as a development release but was not published as a completed stable version. Its finished category management functionality was included in 1.2.7.
- 1.2.6-test was used for preliminary testing and was not promoted to a stable release.
- 1.2.7 is the next stable release following 1.2.4.
Experimental changes from the development branches and open pull requests were not automatically included in the stable release.
Corrected Package Publication
Version 1.2.7-pl-2 corrects the transport package publication in the MODX Extras repository.
The previous publication mistakenly included a package intended for MODX Revolution 2.x.
This corrected release provides the proper MODX Revolution 3.x transport package.
The component functionality remains unchanged from the stable 1.2.7 release.
Documentation
Full release notes and installation packages:
https://github.com/rumata-estor/modx3-mcp/releases/tag/v1.2.7