MODX2MCP

Package Description

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.

Usage/Installation Instructions

1. Install modx2mcp-1.2.0-pl.transport.zip through Package Manager on MODX Revolution 2.8.x. This package is for MODX 2 only. 2. 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. 3. Read the API token from the modxmcp system settings and configure a local MCP client with Node.js 18 or newer. 4. 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. 5. 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