DiviOps
An AI harness for WordPress site authoring — Divi-native today, WordPress-wide by design.
DiviOps gives Claude Code, Codex, Claude Desktop, and other MCP clients a typed control layer over WordPress site state. It pairs an MCP server, a WordPress agent plugin, and skill knowledge so AI agents can author Divi pages, inspect schemas, manage design tokens, work with SCF/CPT data models, run safe WP-CLI operations, and extend into target plugin coverage slices.
Claude Code ◄──► MCP Server (stdio) ◄──► WordPress REST API ◄──► DiviOps Agent plugin
▲
│
divi-5-builder skill
(block format + design rules)
Beta software. DiviOps is under active development. Use on production sites at your own discretion. Always back up your WordPress site before running write operations.
What's in this distribution
| Component | What it is | Where it lives |
|---|
diviops-agent WordPress plugin | REST API endpoints for Divi page data, section targeting, block validation, preset management. The contract layer between WordPress + Divi and the MCP server. | diviops-agent.zip at repo root |
diviops-agent-pro WordPress plugin | Pro add-on for paid coverage slices, Pro license activation, and update gating. Requires diviops-agent. | diviops-agent-pro.zip at repo root in the Pro distribution |
@diviops/mcp-server | Node.js MCP server that bridges MCP clients to WordPress. Distributed via npm — no clone, no build. | npx -y --package @diviops/mcp-server diviops-mcp |
divi-5-builder skill | Block format rules, verified attribute paths, design patterns. Without it, agents guess attr formats and produce broken pages. | skills/divi-5-builder/ (Claude: claude plugin install oaris-dev/diviops; Codex: copy skills/* into ~/.codex/skills) |
diviops-design-library plugin | Optional. CSS entrance animations, gradient text, glass effects, Three.js WebGL shaders. | diviops-design-library.zip at repo root |
Use cases
DiviOps fits multiple WordPress workflows where AI-driven authoring + management is the value:
- Page building (Divi authoring) — create + edit Divi pages, sections, modules, canvases via prompt; preset-driven design system reuse; Theme Builder layouts and templates.
- SCF setup + management — provision Secure Custom Fields field groups, sync schemas, export/import field group definitions; SCF data model becomes a tool surface, not an admin-UI flow.
- CPT + post population — register custom post types via wp-cli passthrough; bulk-populate posts and pages across any post type, not just Divi-built ones.
- Data model reasoning — schema introspection across Divi modules + SCF field groups + post meta; ask Claude what fields a post type carries, what attributes a module accepts, what tokens are defined.
- WordPress site auditing — preset audits, design-token usage scans, orphan detection (presets, variables, dangling references); broader site surveys via wp-cli (
wp option list, wp post list --format=json, wp user list).
- Hybrid sites (Divi + custom PHP) — Divi authors the marketing pages; custom PHP templates handle dynamic ones (CPT listings, single-post views, member portals); design tokens harmonized across both surfaces via CSS custom properties driven from the Divi variable system.
Quick start
Three steps to your first tool call. For containerized environments, HTTPS configuration, and troubleshooting, see SETUP.md.
1. Install the WordPress plugin
Upload diviops-agent.zip (at the root of this repo) via WP Admin → Plugins → Add New → Upload Plugin, then activate it. Requires Divi 5.1+ on WordPress 6.5+.
Verify: visit http://your-site.local/wp-json/diviops/v1/schema/settings — you should get a 401 (auth required).
Free beta updates: the npm MCP server updates through npm, but the Free WordPress plugin is updated manually until the WordPress.org channel is live. Download the latest diviops-agent.zip from the Free GitHub release, upload it via Plugins → Add New → Upload Plugin, and choose Replace current with uploaded. Your Application Password and MCP config stay unchanged.
