Garchi CMS MCP

Garchi CMS for AI agents

Build and manage structured websites and applications with Garchi CMS using AI agents, official starter kits and a production MCP integration.

---

Build with your preferred framework and AI coding agent while Garchi provides the structured content backend. The application is written once; the business keeps managing content afterwards without routine changes to application code.

What Garchi CMS is

Garchi CMS is a hosted headless CMS by LumenHarbor Digital Solutions Limited. Content is organised as:

• Spaces — a work area owning everything below.
• Pages — an ordered list of sections, each an instance of a section template. A template defines props, which map to the props of a component in your codebase.
• Data items — itemable content (blog posts, products, events) with categories and key/value metadata.
• Assets — uploaded files used in page sections.

Your app fetches this over the REST API or the Node/PHP SDK and renders it. It does not replace your framework, database or hosting.

What this repository provides

One installable integration with three parts.

MCP — the hosted Garchi MCP server, https://garchi.co.uk/mcp-oauth. This is how an agent reads and writes your live CMS: listing spaces, creating and editing pages and sections, managing data items, categories, metadata and assets.

Skills — instructions that teach an agent how to use Garchi correctly:

Starter kits — official project scaffolds for Next.js, Nuxt and Laravel, referenced (not copied) from skills/garchi-build-site/references/starter-kits.md.

The repository is packaged as an Agent Plugin (plugin.json + skills/ + mcp.json), with thin adapters for clients that use their own manifest format. The skills live in one place: update a skill and every supported agent gets the change.

Supported agent environments

Cursor

Cursor loads Agent Plugins natively. While the plugin is under marketplace review, install it locally:

git clone https://github.com/lumenharbor/garchi-cms-skills.git ~/.cursor/plugins/local/garchi-cms

Then open Customize in the sidebar, find Garchi CMS, and authenticate the garchi MCP server when prompted.

Claude Code

Add this repository as a plugin marketplace, then install:

/plugin marketplace add lumenharbor/garchi-cms-skills

/plugin install garchi-cms@garchi-cms

Authorize the garchi MCP server with /mcp when prompted.

Codex and the ChatGPT desktop app

Add the repository as a plugin marketplace source:

codex plugin marketplace add lumenharbor/garchi-cms-skills

Then install Garchi CMS from the Plugins Directory in the ChatGPT desktop app and restart it.

If the bundled MCP server does not connect, add it to Codex directly and log in:

codex mcp login garchi

Failing that, add the server by hand in ~/.codex/config.toml:

[mcp_servers.garchi]

url = "https://garchi.co.uk/mcp-oauth"

ChatGPT

Garchi CMS is registered as an MCP connector in ChatGPT: chatgpt.com/plugins/plugin_asdk_app_698da77dd2f48191ba19e15b0b188796. Enable it there to use the Garchi tools in ChatGPT. The plugin's .app.json points Codex and the ChatGPT desktop app at that same registered connector, so a local install reuses it rather than registering the server twice.

Any Agent Plugins-compatible client

Clients that implement the Agent Plugins v1 specification — VS Code and others — read the root plugin.json, the skills/ directory and mcp.json directly. Point the client at this repository.

Skills without a plugin host

To install just the skills into any of the agents supported by the skills CLI:

npx skills@1.7.0 add lumenharbor/garchi-cms-skills

Configure the MCP server separately — see garchi.co.uk/mcp-docs for per-client instructions, including the bearer-token endpoint for clients without OAuth support.

Example prompts

Once installed, these work without naming the MCP server, the skills or the SDK:

• "Build a SaaS marketing site using Garchi CMS."
• "Use Garchi as the CMS for this existing Next.js project."
• "Connect this project to my Garchi space."
• "Create the About and Pricing pages in Garchi."
• "Render my Garchi pages in this frontend."
• "Add a blog to this site backed by Garchi data items."
• "Change the pricing copy in Garchi without changing the application code."
• "Use the official Garchi starter kit to start this project."

Starter kits

Bootstrap any of them:

npx @lumenharbor/garchi-starter-kit@0.1.2 -k next

-k accepts next, nuxt or laravel.

Any other framework — SvelteKit, Astro, Django, Rails, React Native — integrates through the Node SDK, the PHP SDK or the REST API instead. There is no scaffold for those, but Garchi works the same way behind them.

Security

• Authentication is remote and OAuth-based. The bundled MCP server is https://garchi.co.uk/mcp-oauth. It advertises OAuth 2.1 protected-resource metadata (RFC 9728) with PKCE (S256) and dynamic client registration, so supported clients run the authorization flow themselves and store the tokens.
• This repository stores no credentials. No API key, token or secret appears in any manifest, skill or reference file, and none is required to install the plugin. The mcp.json and .mcp.json entries carry a URL and nothing else.
• Your Garchi permissions govern access. The MCP server acts as the signed-in user. The plugin grants no access beyond what that account already has.
• Destructive actions are confirmed. Two tools are marked destructive — delete-section-tool and update-prop-template-tool — and garchi-manage-content requires an explicit, per-item confirmation before either runs, on top of your client's own tool approval prompts.
• Application credentials stay server-side. The GARCHI_API_KEY used by your app to read content is separate from MCP, is never exposed to the browser, and belongs in your own environment configuration — not in this repository.

Documentation

• Garchi CMS documentation
• REST API · OpenAPI spec
• MCP client setup

Agents can be wrong. Check the documentation when something does not behave as a skill describes.

License

MIT — see LICENSE.