The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the GMC YOOtheme MCP Lite listing page.
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 pages 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 |
YOOtheme MCP Base costs EUR 49/year for three sites (12 months, manual renewal). See current plans.
Lite is free to use under the limited commercial licence. Source visibility does not grant redistribution or resale rights.
Python 3.10 or newer. WordPress REST API with an Application Password, or Joomla Web Services with a token. YOOtheme remains a separately licensed product. The generic page list does not prove YOOtheme is installed; layout counts operate on JSON you supply.
Windows:
macOS/Linux:
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.
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.username_env,
password_env, and the applicable Joomla token/key field. Never put
credential values in committed JSON or an MCP chat.YOOTHEME_MCP_LITE_SITES to the absolute path of that local JSON file.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.yootheme_lite_list_sites, then yootheme_lite_ping_site.rest_mode: "query" supports WordPress without pretty REST URLs; otherwise
use pretty. Subdirectory installations are supported in the base URL.
yootheme_lite_list_sites: aliases and platforms only.yootheme_lite_ping_site: one authenticated GET, sanitized status only.yootheme_lite_list_pages: List at most ten page/article titles, ids and status; no content export.yootheme_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.