Craft 5.12 ships its own MCP server: Claude, ChatGPT, Cursor and other AI assistants can read and write your content through it, with Craft's own login and permissions. Craft CMS MCP adds what that server does not do: it tells an assistant how the install is doing, what is going wrong and where the content has gaps, and it gives developers the tools to investigate instead of guess.

It runs inside Craft's server rather than next to it. Clients connect the way Craft documents, permissions are Craft's own, and the plugin's tools appear alongside Craft's.

It knows how the install is doing

One call checks the whole install and says what to fix: devMode or admin changes switched on in production, pending migrations, project config that will not apply (and why), a stuck or failing queue, storage, recent errors. The errors in Craft's logs come back grouped by kind, with a count, first and last seen, and an example stack trace, so "what keeps breaking?" has a one-line answer. Failed queue jobs come with their error. The slowest recent requests come with their query counts and repeated queries. Installed Composer packages are checked against known security advisories.

For agencies there is a maintenance report: health, the most frequent errors, and how much content changed per section and per editor over the period, ready to summarise for a client.

It reviews content before and after it goes live

Before a draft is published, an assistant can show field by field what it changes. Publishing validates the draft the way the control panel does, so a required field cannot go live empty, a check Craft's own MCP publishing skips. Afterwards it can find what slipped through:

  • translations that are missing or still identical to the source site
  • links to deleted, disabled or expired content
  • assets nothing refers to any more
  • a feed of who changed what, across every section

It knows your plugins

When they are installed, it reads Retour's most frequent 404s with a suggested redirect target, SEOmatic's missing or too-long descriptions, titles and social images, and Formie submissions whose integrations failed. With Craft Commerce, it reads products, orders and statuses.

And everything a developer reaches for

Logs, deprecations, routes, console commands, event handlers, config and environment, with credentials redacted. Read-only SQL with schema inspection and EXPLAIN. GraphQL queries and schema exploration. A Tinker tool that runs PHP inside the running application. Natural keys like {"section": "blog", "slug": "my-post"} resolve to the ids Craft's tools take, and preview links let a person review an entry or draft without logging in.

It knows what it may do

Every tool runs as the Craft user who connected, under Craft's own permissions, including whether they may see other authors' entries. Developer and operations tools are for admins only. Tools that run code or write through SQL or GraphQL can be switched off per environment, and are off in production unless you turn them on. php craft mcp/check and the plugin's settings screen confirm that Craft's MCP server and the plugin are set up to work together.

41 tools on every install, plus 3 for Retour, SEOmatic and Formie and 6 for Commerce when those are installed. All of them sit alongside the tools of Craft's own server.

Editions

Lite is the free toolkit for investigating an install: install health, error triage, failed queue jobs, slow requests and security advisories, plus logs, read-only SQL, GraphQL, Tinker, backups, natural keys, preview links and Commerce.

Pro is for managing and maintaining sites: draft review with validated publishing, content health (translation gaps, broken links, unused assets), a change feed across every section, Retour, SEOmatic and Formie insights, a maintenance report for your clients, copying entries between sites, and single Matrix-block editing.

Upgrading from 1.x

2.0 builds on Craft 5.12's own MCP server, so clients reconnect through Craft and the plugin's tools are renamed. The upgrade guide covers each step.

Getting started

Requires Craft 5.12.1 or later. Install via Composer, turn on Craft's MCP server under Settings → MCP, and run php craft mcp/check. The docs cover connecting Claude, ChatGPT, Claude Code and Cursor, the tools reference, configuration and extending.

Lite

Pro

Plus $49/year after one year.

Installation Instructions

To install this plugin, copy the command above to your terminal.

5/ 5
Rating: 5 out of 5 stars
Active Installs
3,249
Version
v2.0.1
License
MIT
Compatibility
Craft 5
Last release
November 17, 2026
Activity (30 days)
5
Closed Issues
0
Open Issues
7
Merged PRs
0
Open PRs