MODX MCP

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

Creator: Alexander Palochkin (rumataestor)

Need help installing this extra?

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

Supported Versions
3.0 - Current

Downloads
72

Documentation
MODX MCP Documentation

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

  • Open Extras → Installer (Package Management) in MODX Revolution 3.x.
  • Install MODX MCP from the MODX Extras repository or upload the MODX 3 transport package modx3mcp-1.2.7-pl.transport.zip.
  • Run the package installer or upgrade the existing installation.
  • Open Extras → MODX MCP 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.
  • Retrieve the generated API token using an authorized Manager account.
  • 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_capabilities and get_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

    Current releases

    1.2.7-pl2
    View | Download
    November 21, 2026
    3.0 - Current

    1.2.4-pl
    View | Download
    October 22, 2026
    3.0 - Current

    1.2.3-pl
    View | Download
    October 15, 2026
    3.0 - Current

    1.2.1-pl
    View | Download
    October 10, 2026
    3.0 - Current

    1.2.0-pl
    View | Download
    October 9, 2026
    3.0 - Current

    1.1.0-pl
    View | Download
    October 9, 2026
    3.0 - Current