{
  "markdown": "<p align=\"center\">\n  <a href=\"https://garchi.co.uk\">\n    <img src=\"assets/logo.png\" alt=\"Garchi CMS\" height=\"70\" title=\"Garchi CMS\" />\n  </a>\n</p>\n\n<h1 align=\"center\">Garchi CMS for AI agents</h1>\n\n<p align=\"center\">\nBuild and manage structured websites and applications with Garchi CMS using AI agents, official starter kits and a production MCP integration.\n</p>\n\n---\n\nBuild with your preferred framework and AI coding agent while Garchi provides\nthe structured content backend. The application is written once; the business\nkeeps managing content afterwards without routine changes to application code.\n\n## What Garchi CMS is\n\n[Garchi CMS](https://garchi.co.uk) is a hosted headless CMS by\n[LumenHarbor Digital Solutions Limited](https://lumenharbor.co.uk). Content is\norganised as:\n\n- **Spaces** — a work area owning everything below.\n- **Pages** — an ordered list of **sections**, each an instance of a **section\n  template**. A template defines **props**, which map to the props of a\n  component in your codebase.\n- **Data items** — itemable content (blog posts, products, events) with\n  **categories** and key/value **metadata**.\n- **Assets** — uploaded files used in page sections.\n\nYour app fetches this over the REST API or the Node/PHP SDK and renders it. It\ndoes not replace your framework, database or hosting.\n\n## What this repository provides\n\nOne installable integration with three parts.\n\n**MCP** — the hosted Garchi MCP server, `https://garchi.co.uk/mcp-oauth`. This\nis how an agent reads and writes your live CMS: listing spaces, creating and\nediting pages and sections, managing data items, categories, metadata and\nassets.\n\n**Skills** — instructions that teach an agent how to use Garchi correctly:\n\n| Skill | Responsibility |\n| --- | --- |\n| [`garchi-build-site`](skills/garchi-build-site) | Orchestration: understand the goal, inspect the project, choose starter kit vs. integration, connect MCP, model the content, verify content stays editable without code changes. |\n| [`garchi-render-content`](skills/garchi-render-content) | The application code: server-side client, page and section renderers, nested sections, data items, metadata, assets, preview mode. |\n| [`garchi-manage-content`](skills/garchi-manage-content) | Content operations over MCP: pages, sections, templates, items, categories, assets — including how to handle destructive actions safely. |\n\n**Starter kits** — official project scaffolds for Next.js, Nuxt and Laravel,\nreferenced (not copied) from\n[skills/garchi-build-site/references/starter-kits.md](skills/garchi-build-site/references/starter-kits.md).\n\nThe repository is packaged as an [Agent Plugin](https://agent-plugins.org)\n(`plugin.json` + `skills/` + `mcp.json`), with thin adapters for clients that\nuse their own manifest format. The skills live in one place: update a skill and\nevery supported agent gets the change.\n\n## Supported agent environments\n\n### Cursor\n\nCursor loads Agent Plugins natively. While the plugin is under marketplace\nreview, install it locally:\n\n```bash\ngit clone https://github.com/lumenharbor/garchi-cms-skills.git ~/.cursor/plugins/local/garchi-cms\n```\n\nThen open **Customize** in the sidebar, find **Garchi CMS**, and authenticate\nthe `garchi` MCP server when prompted.\n\n### Claude Code\n\nAdd this repository as a plugin marketplace, then install:\n\n```bash\n/plugin marketplace add lumenharbor/garchi-cms-skills\n```\n\n```bash\n/plugin install garchi-cms@garchi-cms\n```\n\nAuthorize the `garchi` MCP server with `/mcp` when prompted.\n\n### Codex and the ChatGPT desktop app\n\nAdd the repository as a plugin marketplace source:\n\n```bash\ncodex plugin marketplace add lumenharbor/garchi-cms-skills\n```\n\nThen install **Garchi CMS** from the Plugins Directory in the ChatGPT desktop\napp and restart it.\n\nIf the bundled MCP server does not connect, add it to Codex directly and log\nin:\n\n```bash\ncodex mcp login garchi\n```\n\nFailing that, add the server by hand in `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.garchi]\nurl = \"https://garchi.co.uk/mcp-oauth\"\n```\n\n### ChatGPT\n\nGarchi CMS is registered as an MCP connector in ChatGPT:\n[chatgpt.com/plugins/plugin_asdk_app_698da77dd2f48191ba19e15b0b188796](https://chatgpt.com/plugins/plugin_asdk_app_698da77dd2f48191ba19e15b0b188796).\nEnable it there to use the Garchi tools in ChatGPT. The plugin's `.app.json`\npoints Codex and the ChatGPT desktop app at that same registered connector, so\na local install reuses it rather than registering the server twice.\n\n### Any Agent Plugins-compatible client\n\nClients that implement the [Agent Plugins v1\nspecification](https://agent-plugins.org/specification) — VS Code and others —\nread the root `plugin.json`, the `skills/` directory and `mcp.json` directly.\nPoint the client at this repository.\n\n### Skills without a plugin host\n\nTo install just the skills into any of the agents supported by the `skills`\nCLI:\n\n```bash\nnpx skills add lumenharbor/garchi-cms-skills\n```\n\nConfigure the MCP server separately — see\n[garchi.co.uk/mcp-docs](https://garchi.co.uk/mcp-docs) for per-client\ninstructions, including the bearer-token endpoint for clients without OAuth\nsupport.\n\n## Example prompts\n\nOnce installed, these work without naming the MCP server, the skills or the\nSDK:\n\n- \"Build a SaaS marketing site using Garchi CMS.\"\n- \"Use Garchi as the CMS for this existing Next.js project.\"\n- \"Connect this project to my Garchi space.\"\n- \"Create the About and Pricing pages in Garchi.\"\n- \"Render my Garchi pages in this frontend.\"\n- \"Add a blog to this site backed by Garchi data items.\"\n- \"Change the pricing copy in Garchi without changing the application code.\"\n- \"Use the official Garchi starter kit to start this project.\"\n\n## Starter kits\n\n| Framework | Repository | SDK |\n| --- | --- | --- |\n| Next.js | [garchi-next-starter-kit](https://github.com/lumenharbor/garchi-next-starter-kit) | [`@garchicms/garchi-node-sdk`](https://www.npmjs.com/package/@garchicms/garchi-node-sdk) |\n| Nuxt | [garchi-nuxt-starter-kit](https://github.com/lumenharbor/garchi-nuxt-starter-kit) | [`@garchicms/garchi-node-sdk`](https://www.npmjs.com/package/@garchicms/garchi-node-sdk) |\n| Laravel | [garchi-laravel-starter-kit](https://github.com/lumenharbor/garchi-laravel-starter-kit) | [`garchicms/garchi-sdk-php`](https://packagist.org/packages/garchicms/garchi-sdk-php) |\n\nBootstrap any of them:\n\n```bash\nnpx @lumenharbor/garchi-starter-kit -k next\n```\n\n`-k` accepts `next`, `nuxt` or `laravel`.\n\nAny other framework — SvelteKit, Astro, Django, Rails, React Native — integrates\nthrough the Node SDK, the PHP SDK or the REST API instead. There is no scaffold\nfor those, but Garchi works the same way behind them.\n\n## Security\n\n- **Authentication is remote and OAuth-based.** The bundled MCP server is\n  `https://garchi.co.uk/mcp-oauth`. It advertises OAuth 2.1 protected-resource\n  metadata (RFC 9728) with PKCE (S256) and dynamic client registration, so\n  supported clients run the authorization flow themselves and store the tokens.\n- **This repository stores no credentials.** No API key, token or secret\n  appears in any manifest, skill or reference file, and none is required to\n  install the plugin. The `mcp.json` and `.mcp.json` entries carry a URL and\n  nothing else.\n- **Your Garchi permissions govern access.** The MCP server acts as the signed-in\n  user. The plugin grants no access beyond what that account already has.\n- **Destructive actions are confirmed.** Two tools are marked destructive —\n  `delete-section-tool` and `update-prop-template-tool` — and\n  [`garchi-manage-content`](skills/garchi-manage-content) requires an explicit,\n  per-item confirmation before either runs, on top of your client's own tool\n  approval prompts.\n- **Application credentials stay server-side.** The `GARCHI_API_KEY` used by\n  your app to read content is separate from MCP, is never exposed to the\n  browser, and belongs in your own environment configuration — not in this\n  repository.\n\n## Documentation\n\n- [Garchi CMS documentation](https://garchi.co.uk/documentation)\n- [REST API](https://garchi.co.uk/docs/v2) · [OpenAPI spec](https://garchi.co.uk/docs/v2.openapi)\n- [MCP client setup](https://garchi.co.uk/mcp-docs)\n\nAgents can be wrong. Check the documentation when something does not behave as\na skill describes.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 8297,
  "sha": "ca329fb7ca79aee307660ebb32dc4e2cb5ca7c9d7b0639e0cef17410758f23e1",
  "repo_slug": "lumenharbor/garchi-cms-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_uk_co_garchi_garchi_cms_b876dffa/readme"
}