GMC Builder MCP Lite logo

GMC Builder MCP Lite

Read-only local MCP tools for checking GMC Builder sites and summarizing supplied layout JSON.

Install GMC Builder MCP Lite

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gmc-builder-mcp-lite": {
      "command": "python",
      "args": [
        "-m",
        "gmcbuilder_mcp_lite"
      ],
      "env": {
        "GMCBUILDER_MCP_LITE_SITES": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

python -m gmcbuilder_mcp_lite

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked .

Overview

GMC Builder MCP Lite provides local, read-only access to configured GMC Builder sites on WordPress and Joomla. It runs over stdio and exposes tools for listing site aliases, checking authenticated connectivity, listing up to ten element type names, and summarizing supplied layout JSON. Use it to inspect site availability and basic layout structure before editing. It does not create, edit, publish, export, or restore layouts.

Use cases

  • Check authenticated connectivity to configured GMC Builder sites
  • List site aliases and their CMS platforms
  • Inspect up to ten available builder element type names
  • Summarize node counts and types from local layout JSON

Key features

  • Local stdio MCP server
  • Read-only WordPress and Joomla site checks
  • Authenticated connection probing
  • Element type listing capped at ten results
  • Local layout JSON count and type summaries
  • Restricted HTTPS request handling

Tools4

What GMC Builder MCP Lite lets your agent do. Expand a tool for its parameters.

Self-reported~75 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

10/10 checks healthy over the last 45d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · gmcbuilder_mcp_lite (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit4d agoMost recent push to the default branch.
MaintenanceExperimentalStatus declared by the project or listing owner.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed4Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How GMC Builder MCP Lite works

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.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about GMC Builder MCP Lite

GMC Builder MCP Lite is an MCP server that connects local MCP clients to authorized GMC Builder sites on WordPress or Joomla. Its main tools list configured sites, probe a site, list up to ten element type names, and summarize node counts and types from supplied layout JSON. It is read-only.

Install it from the GitHub repository with Python 3.10 or newer. Clone the repository, create a virtual environment, and install the package with that environment's Python executable. The Lite package is distributed through GitHub rather than PyPI.

Set `GMCBUILDER_MCP_LITE_SITES` to an absolute path containing a local copy of `sites.example.json`. Configure credentials through the environment variables named in each site entry, then pass those variables to the MCP client's child process.

Yes. Cursor can use it as a local stdio MCP server when configured with the absolute Python executable, configuration path, and required credential environment variables.

No. Lite only provides read-only site checks and limited layout inspection; creating, editing, publishing, full export or import, bulk editing, backups, and restoration are unavailable.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGMC Builder MCP Lite AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gmc-builder-mcp-lite?style=directory)](https://allmcps.com/mcp/gmc-builder-mcp-lite)
HTML Embed
<a href="https://allmcps.com/mcp/gmc-builder-mcp-lite"><img src="https://allmcps.com/api/badge/gmc-builder-mcp-lite?style=directory" alt="GMC Builder MCP Lite on AllMCPs" /></a>