Connects to a Joomla site running GMC Builder via the Joomla remote API (2.0.1+) using the shared X-Gmc-Builder-Key; supports read-only site listing, authenticated ping, listing up to ten builder element types, and summarizing supplied layout JSON.
Connects to a WordPress site running GMC Builder via the WordPress authoring API (2.0.0+) using an Application Password; supports read-only site listing, authenticated ping, listing up to ten builder element types, and summarizing supplied layout JSON.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@GMC Builder MCP Lite list my configured GMC Builder sites"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Free limited companion to the GMC Pro product. This is a separate 0.1.1 client with a fresh history and only four read-only MCP tools. The Pro implementation is absent from this repository.
Capability | Lite | Pro product |
Configured site aliases | Yes | Yes |
Authenticated connection probe | Yes | Yes |
Up to 10 element types per call | Yes | Extended tools |
Local supplied JSON: node counts/types | Yes, input up to 64 KiB | Detailed inspection |
Create/edit/publish layouts or documents | No | Paid functionality |
Full export/import, bulk editing, backups | No | Paid functionality |
Private Pro implementation or CMS companion source | Absent | Separately distributed |
Contact gmcfuerte@gmail.com for the Pro product and current annual plans; see the GMC catalogue.
Lite is free to use under the limited commercial licence. Source visibility does not grant redistribution or resale rights.
Related MCP server: mysql-readonly-mcp
Python 3.10 or newer. GMC Builder installed on the target site: WordPress authoring API (2.0.0+) with an Application Password, or Joomla remote API (2.0.1+) with the shared X-Gmc-Builder-Key. This repository does not distribute GMC Builder. Obtain the CMS product through GMC; no layout-export endpoint is included in Lite.
git clone https://github.com/gmcfuerte/gmcbuilder-mcp-lite.git
cd gmcbuilder-mcp-lite
python -m venv .venvWindows:
.venv\Scripts\python.exe -m pip install .macOS/Linux:
.venv/bin/python -m pip install .This Lite edition is distributed through this GitHub repository; it has not been published to PyPI. Do not install the separate full Pro package as a substitute for Lite.
Copy sites.example.json to a local sites.json and keep only the
sites you own or are authorized to access. The file is ignored by Git.
Set the credential environment variables named by username_env,
password_env, and the applicable Joomla token/key field. Never put
credential values in committed JSON or an MCP chat.
Set GMCBUILDER_MCP_LITE_SITES to the absolute path of that local JSON file.
Add the server using mcp.example.json: replace the placeholders with
the absolute Python executable and configuration file paths. Ensure
the MCP client passes the credential variables to its child process.
Start with gmcbuilder_lite_list_sites, then gmcbuilder_lite_ping_site.
rest_mode: "query" supports WordPress without pretty REST URLs; otherwise
use pretty. Subdirectory installations are supported in the base URL.
gmcbuilder_lite_list_sites: aliases and platforms only.
gmcbuilder_lite_ping_site: one authenticated GET, sanitized status only.
gmcbuilder_lite_list_element_types: List at most ten builder element type names; no schema or kit export.
gmcbuilder_lite_summarize_layout: pass the text from layout.example.json
as layout_json. Returns counts and types; no settings or content.
The server runs locally using stdio. No remote HTTP server, uploads, arbitrary URLs, SSH, license switch or Pro modules are included. Online tools use a fixed GET allowlist, verified TLS, no redirects, at most one request at a time per configured base URL, a two-second interval, and a 1 MiB response limit. HTTP is accepted only for exact loopback hosts. HTTP 403/415 stops subsequent requests to that base URL until restart.
Initial Lite release: source and package contents inspected and Python compiled. Site integration and runtime tests have not been performed. Do not treat this initial release as a production integration certification.
GMC · gmcfuerte@gmail.com. Independent GMC software; product names belong to their respective owners.
This server cannot be deployed
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Audit public webpages and supplied markup for HTML, CSS, SEO, JSON-LD, and link issues.
Hosted MCP for website health monitoring. Tools: check_site, list_sites, get_site.
Manage one WordPress site from any MCP client: read, search, propose reviewable changes, SEO data.
