MCP for Gantry 5
Introduction
MCP for Gantry 5 is a free add-on for CS MCP for J, the free extension that turns a Joomla 5 / 6 site into its own MCP server. It gives the AI app you connect (ChatGPT, Claude, Codex, Cursor, VS Code with GitHub Copilot, Gemini CLI or any other MCP app) 21 tools for templates built on the Gantry 5 framework, such as Helium: outlines and which pages use them, layouts, particles, styles, Gantry particle modules, backups and a health check.
Why this exists. Gantry keeps a site's design in YAML files, one set per outline, with inheritance on top. Changing the copyright line or a colour is easy once you know which outline and which file to open, and finding that out is the slow part. This add-on reads those files the way Gantry does, so "change the footer copyright to 2027" lands in the right place, and every answer says which outline a value comes from and which other outlines a change reaches.
What the AI can do. 21 tools in 7 groups:
- Themes and outlines (6): list themes and outlines, read one with its inheritance, see and change which pages use which outline, and create an outline as a copy or as one that inherits.
- Layouts (2): read an outline's layout, and list its module positions with the Joomla modules that land in them.
- Particles (5): list particle types, read and change a particle, and read and change an outline's particle defaults.
- Styles (2): read and change an outline's styles, such as colours, fonts and breakpoints.
- Particle modules (2): list and change Gantry 5 Particle modules.
- Backups (2): list the backups taken before every change, and restore one.
- Diagnostics (2): the health check and Gantry's own cache clearing.
Every tool describes itself to the AI app, so there's nothing to configure. Ask in plain language: "Which outline does the About page use?" or "Make the accent colour darker on the Blog outline."
Changes are careful. Only the keys you name are written, checked against Gantry's own settings, under the theme's custom/config folder. Every changed file is backed up first, read back before it replaces the old one, and can be restored byte for byte. Reading never changes anything: Gantry's own layout reader saves files when its index is stale, so these tools read the YAML themselves.
Colours are checked before they're saved. Gantry stops every page on an outline when a colour won't compile, so the tools accept only the colour formats Gantry compiles.
Gantry's admin can overwrite a fresh theme's outlines. Gantry's installer creates template styles in a way that lets its admin copy the preset over an outline later. The write tools set the style up the way Gantry's admin does first, and the health check warns about styles that still need it.
Permissions. The AI can never do more than the Joomla account it acts for could do in Gantry's own admin. On top of MCP for J's Use and Write permissions, reading needs Access Administration Interface on Gantry 5 or Templates; changes need Edit on Templates; page assignments need Edit on Menus; particle modules follow Joomla's module permissions, as Gantry's particle module editor does. A Custom HTML particle with "Process Twig" switched on runs its content as server-side code, so only a Super User can switch it on or change such content, including when Twig comes from an outline's defaults. Read-only mode in MCP for J limits it to the reading tools.
Getting it. You need CS MCP for J and Gantry 5 (Joomla 6 needs Gantry 5.6.2 or later). Install it from Components → MCP for J → Browse MCP Add-ons or with the downloaded ZIP.
Tested on Joomla 5.4 and 6.1 with Gantry 5.6.7 and Helium 5.6.7: all 21 tools called with every change checked in the files, the database and the rendered page, and the permission checks run with Super User, Administrator and Manager accounts on every tool. Themes with a parent theme, older Gantry layout formats and multilingual sites haven't been tested yet.
Joomla 5 and 6, PHP 8.2+. GPL-2.0-or-later.
Current release: 1.0.1
Documentation: https://docs.cybersalt.com/extensions/mcp-for-gantry-5
Changelog: https://docs.cybersalt.com/extensions/mcp-for-gantry-5/changelog
MCP for Gantry 5
- Version:
- 1.0.1
- Developer:
- Cybersalt
- Last updated:
-
Nov 19 2026
14 hours ago - Date added:
- Nov 17 2026
- License:
- GPLv2 or later
- Type:
- Free download
- Includes:
- p e
- Compatibility:
- J5 J6
Share