MODX EXTRA

MODX2MCP

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

Creator: Alexander Palochkin (rumataestor)

1.2.0-pl

About MODX2MCP

MODX2MCP connects AI agents to MODX Revolution 2.8.x through 192 operations. Manage resources, elements, settings and ClientConfig; inspect access policies and resource groups. Includes dependency analysis, change previews, safety backups, audit hooks and stale-write protection using site revisions. Requires a local Node.js 18+ MCP client.

Information

Released
October 9, 2026

Supported Database
MySQL

License
MIT

Supported Versions
2.8 - <3.0

Downloads
1

Documentation
MODX2MCP Documentation

Instructions

Install modx2mcp-1.2.0-pl.transport.zip through Package Manager on MODX Revolution 2.8.x. This package is for MODX 2 only.

If the previous MODX 2 package named modxmcp is installed, fully uninstall it first, then install modx2mcp. Do not keep both package identities installed side by side. Full uninstall removes the old modxmcp.* settings and API token; verify new settings and update your MCP client token after installation. Subsequent upgrades of modx2mcp preserve settings and token.

Read the API token from the modxmcp system settings and configure a local MCP client with Node.js 18 or newer.

Use npx with github:rumata-estor/modx3-mcp#v1.2.0. Set MODX_MCP_SITE_URL to https://your-site.example/assets/components/modxmcp/api.php and MODX_MCP_TOKEN to your API token. The Node.js MCP client is shared with the MODX 3 distribution.

Begin with read-only operations and enable only the capability groups you need.

Documentation: https://github.com/rumata-estor/modx3-mcp/blob/modx2-v1.2.0/README.md

Based on the original modxMCP project by dampilov94: https://github.com/dampilov94/mcp-component

New in 1.2.0-pl

Separate MODX2MCP distribution for MODX Revolution 2.8.x.
192 actions: 81 read-only and 111 mutation operations.
Runtime CAS and stale-state protection with get_site_state and atomic preconditions.
ClientConfig CRUD/read support and additional access-policy and resource-group reads.
Dependency analysis, change previews, safety backups and external audit hooks.
Shared modxmcp namespace, endpoint and settings for client compatibility.
Validated on MODX 2.8.9-pl with PHP 8.2.32: clean replacement, transport lifecycle, endpoint, CRUD/read smoke and Runtime CAS handshake.