About Nucleo for WordPress
Nucleo is a WordPress page builder for site teams and AI agents, with an MCP server for reading sites and creating drafts under approved permissions. It compiles JSON page documents into HTML and CSS on save and checks SEO and accessibility before publication.
Key features
- 01JSON page schema validation
- 02Core layout and content blocks
- 03HTML and CSS compilation on save
- 04Templates for common site layouts
- 05SEO and accessibility checks
- 06Custom content types and fields
Use cases
- 01Create WordPress page drafts with an AI agent
- 02Build pages from validated JSON documents
- 03Check SEO and accessibility before publishing
MCP support
Its MCP server uses OAuth 2.1 and lets MCP clients read a site and create drafts within approved scopes. It can be reached over the site's HTTP endpoint or through WP-CLI over stdio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://{site_host}/wp-json/nucleo/v1/mcpclaude mcp add --transport http dev-nucleowp-nucleo https://{site_host}/wp-json/nucleo/v1/mcp{"mcpServers":{"dev-nucleowp-nucleo":{"type":"http","url":"https://{site_host}/wp-json/nucleo/v1/mcp"}}}Open in Cursor{"servers":{"dev-nucleowp-nucleo":{"type":"http","url":"https://{site_host}/wp-json/nucleo/v1/mcp"}}}Open in VS Code{"mcpServers":{"dev-nucleowp-nucleo":{"type":"http","url":"https://{site_host}/wp-json/nucleo/v1/mcp"}}}{"mcpServers":{"dev-nucleowp-nucleo":{"serverUrl":"https://{site_host}/wp-json/nucleo/v1/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMENucleo: WordPress page builder with an MCP server for AI agents
Nucleo builds WordPress pages from JSON documents compiled on save. Every frontend request receives HTML and CSS that are already built, so the page builder adds no runtime cost.
Nucleo includes an MCP server with OAuth 2.1. Claude, Cursor and other MCP clients read the site and create drafts with the permissions you approve. A quality engine checks SEO and accessibility before a page goes live.
- Website: nucleowp.dev
- Documentation: nucleowp.dev/en/docs
- Version in this repository: 0.4.1
Features
- JSON document schema with field validation.
- Core blocks: section, container, heading, text, image, button, menu, accordion, tabs, slider and more.
- Compiler with HTML and CSS output, on save.
- Header, footer, single, archive, search and 404 layouts.
- Quality engine with SEO and accessibility checks.
- Content model: custom post types, taxonomies and field groups, with repeater and relation fields.
- MCP server for AI agents, with OAuth 2.1.
- WP-CLI commands.
Requirements
- WordPress 6.9 or later.
- PHP 8.2 or later.
- MySQL 5.7 or MariaDB 10.4 or later. OPcache is recommended.
Install
- Download the zip of the latest release from the Releases page, or from nucleowp.dev/en/download.
- In WordPress, open Plugins → Add New → Upload Plugin and install the zip.
- Activate Nucleo. On activation the plugin checks PHP, WordPress, OPcache and write permissions.
Connect an AI agent
The MCP server answers at this address on your site:
https://your-site.com/wp-json/nucleo/v1/mcp
Claude Code:
claude mcp add --transport http nucleo https://your-site.com/wp-json/nucleo/v1/mcp
WP-CLI, over STDIO, with the permissions of the given user:
wp nucleo mcp --user=admin
The client opens the authorization page in WordPress. You choose the scopes and approve. The full guide is at Connect an AI agent.
About this repository
This repository is a read-only mirror of the free plugin, the same code published on WordPress.org. Each Nucleo release updates it automatically, with a commit and a vX.Y.Z tag. Pull requests are not merged here.
To report a bug or ask for a feature, use nucleowp.dev/en/feedback.
License
GPL-2.0-or-later. See LICENSE.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.