Total CMS MCP server
Commit Nov 14, 2026Exposes flat-file site collections and schemas to AI agents for direct querying and content management.
Also known as totalcms/cms, cms
- Stars
- 10
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.2
- Last commit
- Nov 14, 2026
- License
- —
What is Total CMS MCP?
Total CMS exposes flat-file site collections and schemas to AI agents for direct querying and content management.
Summary generated from the project's README
About Total CMS MCP server
Total CMS provides a way for AI agents to interact with flat-file website content stored as JSON files. This system is built on PHP 8.2 or higher and uses the Slim 4 framework to manage site collections and schemas without requiring a MySQL database. Developers can connect an agent to a live site using the built-in MCP server available in the Pro edition to perform direct queries on site data.
Users can manage content through a REST API using API-key or OAuth 2.1 authentication. The platform includes 33 built-in collection types like blog and gallery, alongside unlimited custom schemas. For local development and management, the tcms command-line interface allows for importing, exporting, and syncing data. This setup is intended for web designers and agencies who want to treat content like code by version-controlling JSON files on disk.
What you can do with it
- 1Query site contentAsk an AI agent to retrieve specific data from your website collections.
- 2Manage site schemasHave an AI agent inspect or modify the structure of your content collections.
- 3Automate site buildingInstruct an agent to use the site builder workflow to add new pages.
Written from the project's README. Every use case is checked against a quote from it.
How to install Total CMS MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Total CMS MCP in Claude Code
$ claude mcp add --transport http cms https://totalcms.co/mcpInstall Total CMS MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cms": {
"url": "https://totalcms.co/mcp"
}
}
}Install Total CMS MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cms": {
"type": "http",
"url": "https://totalcms.co/mcp"
}
}
}Install Total CMS MCP in VS Code CLI
$ code --add-mcp '{"name":"cms","type":"http","url":"https://totalcms.co/mcp"}'Install Total CMS MCP in Codex
$ codex mcp add cms --url https://totalcms.co/mcpInstall Total CMS MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cms] url = "https://totalcms.co/mcp"
Install Total CMS MCP in Gemini CLI
$ gemini mcp add -s user --transport http cms https://totalcms.co/mcpInstall Total CMS MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cms": {
"url": "https://totalcms.co/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabletotalcms/cms is public and reachablegithub.com/totalcms/cms ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-13github.com/totalcms/cms ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 306 msPass
README
View on GitHubTotal CMS
About
Total CMS is a content management system built on PHP 8.2+ and Slim 4 that stores content as flat JSON files instead of in a database. There is no MySQL to provision, no migrations to run, and no plugin ecosystem to keep patched — content lives on disk, so it version-controls, backs up, and deploys like the rest of your code.
It is designed for web designers, freelancers, and agencies who want structured content and a polished admin for their clients, on any commodity PHP host.
- No database — content is JSON on disk; deploy by copying files
- 33 built-in collection types — blog, image, gallery, file, and more — plus unlimited custom schemas
- Twig templating — 89 custom filters and 49 functions on top of stock Twig 3
- Site Builder — add a page in the admin and it is live; no build or generate step
- REST API — full CRUD for headless use, with API-key or OAuth 2.1 authentication
- Built-in MCP server — exposes your site's collections and search to AI agents (Pro)
- Automations — schedule, webhook, and event-triggered handlers with a job queue
- Extensions — a register/boot lifecycle with capability-based permissions
- Admin interface — form builder with 20+ field types, media management, passkey login
- CLI (
tcms) — collections, schemas, objects, import/export, sync, and deploys - Image processing — on-the-fly resizing, watermarking, and OKLCH color handling
Requirements
- PHP 8.2+ (8.4 supported)
- Composer 2.0+
- Apache or Nginx with URL rewriting
- PHP extensions: GD or ImageMagick, JSON, Fileinfo, OpenSSL
No database server. No Node.js runtime in production.
Installation
composer create-project totalcms/totalcms mysite
cd mysite
Point your web server's document root at public/, then open the site in a browser — the
setup wizard handles the admin account, data directory, and license from there.
The installer also offers a subpath layout, which serves Total CMS from /tcms/ and leaves
public/ free for your own frontend build. See the
Installation Guide for web server
configuration.
Twig templates
{% for post in cms.collection.objects('blog') %}
<article>
<h2>{{ post.title }}</h2>
{{ post.content|markdown }}
</article>
{% endfor %}
See the Twig documentation for the full filter and function reference.
CLI
vendor/bin/tcms collection:list
vendor/bin/tcms jumpstart:export backup.json
vendor/bin/tcms cache:clear
vendor/bin/tcms deploy
For AI agents
Total CMS is built to be worked on by coding agents:
- llms.txt and llms-full.txt — the complete documentation in one fetch
- Agent skill — installed into
.claude/skills/automatically oncomposer install, covering collections, schemas, the CLI, and the Site Builder workflow - Built-in MCP server — point an agent at a live site to query its collections and schemas directly (Pro edition)
Documentation
Full documentation is at docs.totalcms.co.
Support
License
Total CMS is commercial software. A license is required for production use. See LICENSE.md for terms.
Free 45-day trials are available — no credit card required. Visit totalcms.co for details.
Total CMS MCP questions
How do I add Total CMS MCP to Claude Code?
Run claude mcp add --transport http cms https://totalcms.co/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Total CMS MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does Total CMS require a database?
No, it is a flat-file CMS that stores content as JSON files on disk.
What are the system requirements?
You need PHP 8.2+ (8.4 supported), Composer 2.0+, and Apache or Nginx with URL rewriting.