GMC YOOtheme MCP Lite

io.github.gmcfuertev0.1.1Updated Oct 5, 2026

Limited local read-only MCP companion: GMC YOOtheme MCP Lite.

VerifiedSTDIODesktop onlyDeveloper ToolsFiles & Storage

Overview

AI-generated overview

A local read-only MCP companion for YOOtheme sites that lists configured site aliases, probes authenticated connections, lists pages, and summarizes supplied…

What it does
This Lite edition exposes four read-only tools: yootheme_lite_list_sites returns aliases and platforms, yootheme_lite_ping_site performs one authenticated GET and returns a sanitized status, yootheme_lite_list_pages lists up to ten page or article titles, ids and status, and yootheme_lite_summarize_layout returns node counts and types from layout JSON you pass in. It runs locally over stdio and uses a fixed GET allowlist with verified TLS, no redirects, rate limiting and a 1 MiB response limit. It cannot create, edit or publish layouts or documents, and full export, import, bulk editing and backups are absent.
When to use it
Use it when you want an assistant to check connectivity to WordPress or Joomla sites running YOOtheme and to read basic page listings or layout structure without granting write access. It is a free, limited companion to a paid Pro product, so it is not a substitute for full site management.
Requirements
Python 3.10 or newer, installed from the GitHub repository rather than PyPI. A local sites.json configuration file, the YOOTHEME_MCP_LITE_SITES environment variable pointing to its absolute path, and credential environment variables named by username_env, password_env and the applicable Joomla token or key field. WordPress needs a REST API Application Password; Joomla needs Web Services with a token. The MCP client must pass the credential variables to the child process.
Before you install
Credentials are supplied through environment variables such as username_env, password_env and the Joomla token or key field; never place credential values in committed JSON or an MCP chat. The server performs authenticated GET requests against configured sites, so it contacts third-party systems. HTTP 403 or 415 responses stop further requests to that base URL until restart. The initial release has not had site integration or runtime tests and should not be treated as production certification.

Installation

In SourceWeft

  1. Open GMC YOOtheme MCP Lite in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

YOOtheme MCP Lite

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.

Lite and Pro

CapabilityLitePro product
Configured site aliasesYesYes
Authenticated connection probeYesYes
Up to 10 pages per callYesExtended tools
Local supplied JSON: node counts/typesYes, input up to 64 KiBDetailed inspection
Create/edit/publish layouts or documentsNoPaid functionality
Full export/import, bulk editing, backupsNoPaid functionality
Private Pro implementation or CMS companion sourceAbsentSeparately 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.

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

console
git clone https://github.com/gmcfuerte/yootheme-mcp-lite.gitcd yootheme-mcp-litepython -m venv .venv

Windows:

console
.venv\Scripts\python.exe -m pip install .

macOS/Linux:

console
.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

  1. 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.
  2. 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.
  3. Set YOOTHEME_MCP_LITE_SITES to the absolute path of that local JSON file.
  4. 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.
  5. Start with 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.

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 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.

Release status

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.

Contact

GMC · [email protected]. Independent GMC software; product names belong to their respective owners.

Source: README.md at commit 5012fad

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.1LatestOct 5, 2026