MODX2MCP

AI-agent tools for MODX 2 with backups and dependency analysis

Creator: Alexander Palochkin (rumataestor)

Need help installing this extra?

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

Supported Versions
2.8 - <3.0

Downloads
60

Documentation
MODX2MCP Documentation

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

  • Download the modx2mcp-1.2.7-pl-2.transport.zip package.
  • Open Extras → Installer (Package Management) in MODX Revolution 2.8.x.
  • Install the package from MODX Extras or upload the transport ZIP manually.
  • Run the package installer.
  • Open Extras → MODX2MCP in the MODX Manager.
  • Review the security settings and available MCP capabilities.
  • New installations have API access disabled by default. Enable it explicitly when ready.
  • Configure your MCP client using the site's API endpoint and authentication token.
  • 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

  • Verify the package installation.
  • Confirm that existing system settings and API tokens are preserved after an upgrade.
  • Check MCP connectivity.
  • Verify available tools and permissions.
  • Review security settings before enabling external access.
  • 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_capabilities and getSiteState.
    • 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

    Current releases

    1.2.7-pl2
    View | Download
    November 21, 2026
    2.8 - <3.0

    1.2.4-pl
    View | Download
    October 22, 2026
    2.8 - <3.0

    1.2.3-pl
    View | Download
    October 15, 2026
    2.8 - <3.0

    1.2.1-pl
    View | Download
    October 10, 2026
    2.8 - <3.0

    1.2.0-pl
    View | Download
    October 9, 2026
    2.8 - <3.0