Elementor MCP Lite

Elementor 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

Contact [email protected] for the Pro product and current annual plans; see the GMC catalogue.

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 with Elementor and the GMC Elementor MCP companion (0.5.0+), plus a WordPress Application Password. The companion is obtained separately from GMC at [email protected]; its implementation is not included in this repository. Pro is required for the corresponding Elementor Pro features. Lite's MCP ping checks the companion, not theme editing capability.

Install from GitHub

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

Windows:

.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

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 ELEMENTOR_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 elementor_lite_list_sites, then elementor_lite_ping_site.

rest_mode: "query" supports WordPress without pretty REST URLs; otherwise use pretty. Subdirectory installations are supported in the base URL.

Tools

• elementor_lite_list_sites: aliases and platforms only.
• elementor_lite_ping_site: one authenticated GET, sanitized status only.
• elementor_lite_list_documents: List at most ten Elementor document titles, ids and status; no document export.
• elementor_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.