GMC Builder MCP Lite
This MCP server provides four read-only, local stdio tools for inspecting configured GMC Builder sites and supplied layout JSON, without editing or exposing content.
List configured site aliases and platform names.
Probe a configured site with one authenticated GET and return only sanitized connection status.
List at most ten builder element type names; no schema or kit export.
Summarize supplied layout JSON (up to 64 KiB) into node counts and types only, never settings or content.
Does not create, edit, publish, import/export, bulk-edit, back up, upload, access arbitrary URLs, use SSH, switch licenses, or include Pro functionality.
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.
GMC Builder MCP Lite
Free limited companion to the GMC Pro product. This is a separate 0.1.3 client with a fresh history and only four read-only MCP tools. The Pro implementation is absent from this repository.
Lite and Pro
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 |
See Pro features and current annual plans. Contact gmcfuerte@gmail.com for companion requirements or product questions.
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
Upgrade to Pro in your MCP client
Open the resource Upgrade to Pro (gmc://lite/pro-features) to see the
capability comparison and the product's current plans. Editing, publishing,
full import/export, bulk editing and restoration are labelled unavailable
in Lite. They are informational previews; no Pro code or executable Pro
tools are bundled. The free tools keep working without an upgrade.
MCP clients decide how resources are displayed, so this is not a guaranteed popup or a graphical settings panel. Ask your assistant to read the resource if its client does not expose a resource browser.
Guide and presentation
Practical Lite guide (English): prerequisites, setup and a first read-only session.
Presentation for clients (Italian PDF): a short overview of the three Lite clients and the separate Pro editions.
Prerequisites
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.
Install from GitHub
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.
Configure
Copy
sites.example.jsonto a localsites.jsonand 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_SITESto 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, thengmcbuilder_lite_ping_site.
rest_mode: "query" supports WordPress without pretty REST URLs; otherwise
use pretty. Subdirectory installations are supported in the base URL.
Tools
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 fromlayout.example.jsonaslayout_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.
Release status
Version 0.1.3 fixes line breaks in the capability-comparison resource; the four tools remain read-only and no Pro editing code is included. The release notes record scoped checks of current CMS read probes and exact MCPB uv startup on Windows/Python 3.13.
These checks do not certify graphical-host installation, macOS/Linux, production use or every upstream vendor feature. CMS requests still require the separate GMC Builder extension and its authorized API access; Lite contains no authoring or export endpoints.
Contact
GMC · gmcfuerte@gmail.com. Independent GMC software; product names belong to their respective owners.
Available Tools
4 toolsgmcbuilder_lite_list_element_typesBRead-onlyIdempotent
List at most ten builder element type names; no schema or kit export.
Inputs: site (required), limit.
gmcbuilder_lite_list_sitesARead-onlyIdempotent
List configured site aliases and platform names; never expose credentials.
Inputs: no named parameters.
gmcbuilder_lite_ping_siteBRead-onlyIdempotent
Perform a single authenticated read; return only connection status.
Inputs: site (required).
gmcbuilder_lite_summarize_layoutARead-onlyIdempotent
Summarize supplied JSON node types; never return layout content or settings.
Inputs: layout_json (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct action: enumerating sites, checking one site's connection, enumerating element type names, and summarizing supplied JSON. The only mild overlap is list_sites vs ping_site, both site-scoped, but their descriptions (enumeration vs a single authenticated read returning only status) make the boundary clear.
All four tools follow the same gmcbuilder_lite_verb_noun pattern (list_sites, ping_site, list_element_types, summarize_layout) with consistent snake_case and consistent verb style. No mixed conventions.
Four tools is on the lean side but coherent for an explicitly 'Lite' read-only introspection server; each tool covers a distinct capability. It is slightly thin, with no tool for retrieving a single site's or element type's detail, but nothing is redundant.
The surface covers discovery (sites, element types) and one diagnostic (ping) plus layout summarization, but stops there: there is no way to get details for a specific site or element type, and the descriptions explicitly exclude schema/kit export and layout content. These are deliberate safety limits, yet they leave notable gaps for anything beyond a shallow read.
Maintenance
Related MCP Connectors
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.
Read-only MCP server that answers questions about turva.dev from its published data. Five tools return JSON: the service catalog with prices, contact and operator details, engagement principles and dated agent-readiness and security evidence with verification links. Connect over Streamable HTTP. You need no API key. The server does not scan other websites or run audits.
Public AI web-readiness scanner and machine-facing observability discovery service.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables safe, local DevOps inspection through a JSON-lines server with schema validation, path isolation, and redaction, supporting read-only Git operations, Kubernetes YAML validation, Terraform plan summaries, and sanitized log analysis.MIT
- AlicenseAqualityCmaintenanceEnables MCP clients such as Codex to safely inspect a MySQL database over stdio by listing tables, describing schemas and indexes, and running only validated single read-only SELECT/CTE queries plus JSON EXPLAIN plans. Queries execute inside read-only transactions with strict AST-based rejection of writes, multi-statements, and other risky operations, and results come back as structured JSON.687 npmMIT
- AlicenseAqualityBmaintenanceEnables MCP-aware agents to read and explore Oracle Cloud Infrastructure — listing, fetching, and searching across 39 resource types spanning Identity, Compute, Block Volume, Networking, Object Storage, and OKE. Runs locally over stdio using credentials from ~/.oci/config, with fail-closed safety gates and audit logging governing future write operations.4Apache 2.0
- FlicenseBqualityBmaintenanceEnables authenticated, read-only access to configured WordPress or Joomla sites through four MCP tools for site listing, connection checks, page/article listing, and summarizing supplied layout JSON.4-