# GMC Builder MCP Lite [Verified owner] [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/gmcfuerte/gmcbuilder-mcp-lite  
**GitHub Stars:** 0  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gmc-builder-mcp-lite

## Description
For site owners and developers checking GMC Builder before editing. Lite 0.1.2 offers four local, read-only MCP tools: site aliases, connection checks, up to 10 element type names and counts from supplied JSON. Requires Python 3.10+, GMC Builder authoring API 2.0.0+ on WordPress with an Application Password, or remote API 2.0.1+ on Joomla with its shared key. No editing, publishing or full export; paid Pro is separate. Setup and plans: https://fuerteventuratv.net/en/cms/gmcbuilder-mcp. Contact: gmcfuerte@gmail.com.

## Tools
Capabilities this server exposes over MCP:

- **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`

## Claude Desktop Quick Installation
Install path inferred — verify against the README before running it. Uses `python` (confidence: medium):

```json
"mcpServers": {
  "gmc-builder-mcp-lite": {
    "command": "python",
    "args": ["-m","gmcbuilder_mcp_lite"],
    "env": {
      "GMCBUILDER_MCP_LITE_SITES": ""
    }
  }
}
```

**Requires environment variables:** `GMCBUILDER_MCP_LITE_SITES` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What GMC Builder MCP Lite does

GMC Builder MCP Lite gives an MCP client a small set of read-only checks for GMC Builder installations. It connects to authorized WordPress sites through the GMC Builder authoring API and to Joomla sites through the GMC Builder remote API. The WordPress integration requires GMC Builder authoring API 2.0.0 or newer and an Application Password. Joomla requires remote API 2.0.1 or newer and the shared `X-Gmc-Builder-Key`.

The package is intended for site owners and developers who want to verify connections or inspect limited layout information before making changes. It is a separate Lite implementation; Pro modules and the Pro implementation are not included.

## How it works

The server runs locally as a Python process and communicates with MCP clients through stdio. Configured sites are read from a local JSON file, while credentials are supplied through environment variables referenced by that configuration. The server should be given only sites the operator owns or is authorized to access.

Online checks use a constrained request model: authenticated GET requests, a fixed allowlist, TLS verification, no redirects, 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. A 403 or 415 response prevents further requests to that base URL until the process restarts.

## Setup and configuration

Python 3.10 or newer is required. Install the package directly from the GitHub repository rather than PyPI:

1. Clone the repository and create a virtual environment.
2. Install it with the environment's Python executable.
3. Copy `sites.example.json` to a local `sites.json` and keep it outside committed credentials.
4. Set `GMCBUILDER_MCP_LITE_SITES` to the absolute path of that file.
5. Configure the credential environment variables named by `username_env`, `password_env`, and the applicable Joomla token or key field.
6. Add the process to the MCP client using absolute paths for the Python executable and configuration file.

WordPress installations can use `rest_mode: "query"` when pretty REST URLs are unavailable; `pretty` is the other supported mode. Subdirectory installations are supported in the base URL. A useful first session starts with site listing, followed by a connection probe.

## Tools and capabilities

- `gmcbuilder_lite_list_sites` returns configured aliases and platforms only.
- `gmcbuilder_lite_ping_site` performs one authenticated GET and returns a sanitized status.
- `gmcbuilder_lite_list_element_types` returns no more than ten builder element type names. It does not provide schemas or kit exports.
- `gmcbuilder_lite_summarize_layout` accepts the text from `layout.example.json` as `layout_json` and returns element counts and types without settings or content.

## Limitations and notes

Lite is strictly read-only. It cannot create, edit, or publish layouts or documents, and it does not provide full import/export, bulk editing, backups, or restoration. No layout-export endpoint, remote HTTP server, uploads, arbitrary URLs, SSH access, license switch, or Pro tools are included.

The target CMS product is obtained separately through GMC. Lite is distributed from GitHub and is licensed under a limited commercial licence. Its site integration and runtime behavior should not be treated as production integration certification.

_Full upstream README: https://allmcps.com/mcp/gmc-builder-mcp-lite/readme_

