logo
OverviewWordPress Plugin

SproutOS WordPress Plugin: AI-Powered Site Management via MCP

The SproutOS WordPress plugin connects AI agents to your WordPress site through the Model Context Protocol (MCP). Manage files, themes, pages, and code execution from any MCP-compatible AI client.

The SproutOS WordPress plugin gives AI agents direct, programmatic control over your WordPress installation through the Model Context Protocol (MCP). Instead of copying code between an AI chat and your site manually, the plugin lets your AI client read files, write code, edit themes, create pages, and execute PHP, all within a sandboxed, permission-controlled environment. It runs on WordPress 6.5+ with PHP 8.0+.

What Problem Does It Solve

Traditional AI-assisted WordPress development is a copy-paste workflow. You describe what you want in ChatGPT or Claude, copy the generated code, paste it into your editor, test it, then go back to the AI to report what happened. The AI has no direct access to your database, file system, theme files, or WordPress APIs.

The SproutOS plugin eliminates this loop. It exposes your WordPress site as a set of structured tools that any MCP-compatible AI client can call directly. The AI reads your files, understands your site structure, makes changes, and verifies results, all in one conversation.

How It Works

The plugin is built on three open standards:

LayerWhat It Does
Model Context Protocol (MCP)An open protocol that lets AI clients call tools on external systems through a standardized interface
WordPress Abilities APIA WordPress core API (6.5+) that lets plugins register callable abilities with input/output schemas

SproutOS registers its tools as WordPress abilities and exposes them over HTTP through the MCP protocol. Your AI client connects via MCP and calls them like any other tool.

Abilities Overview

SproutOS provides 20 tools organized into five modules:

ModuleAbilitiesWhat It Covers
Ops8 toolsFile read, write, edit, delete, directory listing, PHP execution, sandbox enable/disable
Theme4 toolsList theme files, read theme file, update theme file, update stylesheet
WordPress2 toolsCreate page, update page
Bridge3 toolsDiscover available tools, dispatch any ability, inspect tool schemas
Filesystem3 toolsBatch execute multiple operations, get/update MCP settings

Abilities Reference

Full documentation of every tool with parameters, return values, and examples.

Who Is This For

  • WordPress developers building or maintaining sites who want AI assistance with direct site access
  • Agencies managing multiple WordPress sites and looking to automate repetitive tasks
  • Theme developers who want AI agents to read, modify, and test theme files directly
  • Technical site administrators comfortable with PHP, WordPress internals, and command-line tools

The SproutOS plugin is designed for development and staging environments only. Do not use it on production sites without understanding the security implications. Always keep backups.

Admin Dashboard

The plugin adds a SproutOS menu item in your WordPress admin with six tabs:

TabPurpose
ConnectGenerate and manage application passwords for AI client authentication
AI AbilitiesToggle individual tools on or off, enable safe mode
SandboxManage custom ability files in the sandbox directory
ActivityView analytics: execution logs, session history, CSV export
PrivacyControl data collection and IP anonymization settings
SettingsConfigure log retention, webhooks, and module toggles

Frequently Asked Questions

Next Steps