YOOtheme MCP Lite
This is a free, read-only YOOtheme MCP Lite server that inspects configured CMS sites and supplied layout JSON, without any editing or publishing capability.
List configured site aliases and their platform names (
yootheme_lite_list_sites) — credentials are never exposed.Probe a site with one authenticated GET request and get back only sanitized connection status (
yootheme_lite_ping_site).List up to 10 page/article titles, ids and status for a site (
yootheme_lite_list_pages, default limit 10) — no content export.Summarize node counts and types from layout JSON you paste in up to 64 KiB (
yootheme_lite_summarize_layout) — no settings or content returned.Works locally over stdio with WordPress (Application Password) or Joomla (Web Services token); all tools are read-only and destructive actions are unavailable — creating, editing, publishing, import/export, bulk editing and backups require the separate Pro product.
Provides authenticated connectivity checks and read-only page/article listing for Joomla sites via Joomla Web Services using a token, returning at most ten titles, IDs, and statuses without content export.
Provides authenticated connectivity checks and read-only page/article listing for WordPress sites via the WordPress REST API, returning at most ten titles, IDs, and statuses without content export.
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., "@YOOtheme MCP Lite list the first 10 pages on my WordPress site"
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.
YOOtheme MCP Lite
Free limited companion to the GMC Pro product. This is a separate 0.1.4 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 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.
Related MCP server: wpagent-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. 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.
Install from GitHub
git clone https://github.com/gmcfuerte/yootheme-mcp-lite.git
cd yootheme-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
YOOTHEME_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
yootheme_lite_list_sites, thenyootheme_lite_ping_site.
rest_mode: "query" supports WordPress without pretty REST URLs; otherwise
use pretty. Subdirectory installations are supported in the base URL.
Tools
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 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.4 fixes line breaks in the capability-comparison resource. The four read-only tools remain; no Pro editing code is included. The release checks recorded for 0.1.4 include current CMS read probes and exact MCPB uv startup on Windows/Python 3.13.
Version 0.1.3 corrected Joomla Web Services content negotiation: Joomla requests use Accept: application/vnd.api+json, while WordPress keeps application/json. Four HTTP regression tests cover both platforms, the endpoint allowlist and the HTTP 403/415 fail-stop. On 26 October 2026, a clean Python 3.13 installation with MCP SDK 1.30.0 passed stdio startup, all four tools and read-only calls against disposable WordPress 7.1.3 and Joomla 6.1.4 sites with YOOtheme Pro 5.0.53. Package installation and upgrade from 0.1.2 were also checked.
These are scoped Windows laboratory results. They do not certify graphical-host installation, macOS/Linux or every upstream vendor feature. YOOtheme remains separately licensed.
On 4 November 2026, Lite 0.1.4 passed all four read-only tools against disposable Joomla 6.1.4 and WordPress 7.1.4 instances, both running YOOtheme Pro 5.0.53. These results cover local Windows testing only; they do not certify production hosting, other platforms, or every YOOtheme feature.
Contact
GMC · gmcfuerte@gmail.com. Independent GMC software; product names belong to their respective owners.
Available Tools
4 toolsyootheme_lite_list_pagesBRead-onlyIdempotent
List at most ten page/article titles, ids and status; no content export.
Inputs: site (required), limit.
yootheme_lite_list_sitesARead-onlyIdempotent
List configured site aliases and platform names; never expose credentials.
Inputs: no named parameters.
yootheme_lite_ping_siteCRead-onlyIdempotent
Perform a single authenticated read; return only connection status.
Inputs: site (required).
yootheme_lite_summarize_layoutBRead-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 targets a distinct action and resource: listing sites, pinging a site, listing pages, and summarizing layout JSON. No two tools overlap in purpose, and the descriptions clearly delineate their boundaries.
All tool names follow the same yootheme_lite_ prefix and snake_case verb_noun pattern (list_sites, ping_site, list_pages, summarize_layout). This consistency makes them predictable and easy to select.
Four tools are appropriate for a 'lite' server focused on safe, read-only introspection. Each tool earns its place without redundancy, and the count is well within the typical 3–15 range.
The surface covers listing and basic checks but lacks get operations for individual sites, pages, or layouts, and has no write or update capabilities. While intentional for a lite server, these gaps limit deeper inspection and may force agents to seek other tools.
Maintenance
Related MCP Connectors
WordPress plugin exposing 60 MCP tools via OAuth 2.1: posts, pages, media, users, comments and SEO.
Audit, rank-track and analyze SEO for sites via an authenticated MCP server.
Create website projects, deploy GitHub sites and read logs/usage via remote OAuth MCP.
Create and manage Lindo AI websites, pages, blogs, clients, and credits from any MCP client.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables interaction with WordPress sites through the WordPress REST API, dynamically exposing all routes as MCP tools for content management and site configuration.-
- AlicenseBqualityDmaintenanceEnables MCP-compatible clients to securely operate a WordPress site through a signed REST API, managing plugins, content, themes, menus, media, users, WooCommerce, Elementor, audits, and allowlisted WP-CLI commands.5856 npmMIT
- AlicenseNot gradedqualityCmaintenanceManages WordPress sites over the REST API, enabling users, posts/pages, media, ACF fields, and Elementor page operations through MCP-compatible clients.MIT
- FlicenseNot gradedqualityBmaintenanceProvides MCP servers to interact with WordPress sites via REST API, supporting multiple sites and aggregated tools.-