modxmcp

Exposes your MODX site over the Model Context Protocol so AI agents and MCP clients can administer it the way a person would through the Manager. Every write goes through MODX processors, so SeoSuite, Collections, cache invalidation and lifecycle events all fire. Token auth with scopes, a full audit log, opt-in uploads and object access. PHP 8.1+, MODX 3.0+, zero dependencies.

Requires PHP 8.2+ (was 8.1; the extra never actually ran on 8.1).

• Fixed data loss: element_save wiped a snippet, plugin or template's default properties because nothing could read them back first. element_get and element_delete now return them.
• Tool refusals come back as tool results, not protocol errors, so clients stop showing them as transport failures. The audit log records them.
• MODX core classes are now discovered, so the class guard works and refusals say why instead of "Unknown class".
• New tools: media_source_list and category_delete.
• tools/list is filtered by token scope.
• cache_refresh now clears the discovery cache.

No data changes; settings, tokens and the audit log are preserved.