wordpress-boost

WordPress Boost provides AI-assisted tooling to deeply inspect a WordPress project, audit security, generate realistic test data, and guide AI agents with curated guidelines and skills. It exposes a suite of tools for examining hooks, post types, taxonomies, REST endpoints, database schema, options, and server configuration, as well as security-related checks and development context utilities. After initializing, you can rely on editors like Claude Code, Cursor/VS Code, or Windsurf to auto-discover the MCP server and begin issuing commands to gather context about your WordPress installation. The included AI guidelines live under the .ai/ directory in your project and supply WordPress best practices for themes, plugins, REST API usage, Gutenberg blocks, ACF, and WooCommerce, helping AI agents generate safer, more consistent code.

To use WordPress Boost, install and configure it in your WordPress project, initialize the MCP config, and then run the provided wp-boost command through your chosen MCP client. Use the available tools to fetch site information, inspect hooks, view database schema, enumerate REST endpoints, and perform security audits. The system is designed to work with any AI agent, enabling it to request the exact WordPress context it needs to produce correct, idiomatic code or configuration changes.

Prerequisites:

• PHP installed on your machine (and available in your PATH)
• WordPress project you want to analyze
• Composer (recommended) or the option to install WordPress Boost without Composer

Install with Composer (recommended):

cd /path/to/wordpress
composer require thanoseleftherakos/wordpress-boost --dev
php vendor/bin/wp-boost --init

This initializes the MCP configuration (.mcp.json) and installs AI guidelines and skills into the .ai/ directory.

Using WordPress Boost without Composer:

# Clone the package outside your WordPress project and install locally
git clone https://github.com/thanoseleftherakos/wordpress-boost.git ~/wordpress-boost
cd ~/wordpress-boost
composer install

# Initialize in your WordPress project
cd /path/to/wordpress
php ~/wordpress-boost/bin/wp-boost --init

Then edit the generated .mcp.json to point to your local wp-boost script, for example:

{
  "servers": {
    "wordpress-boost": {
      "command": "php",
      "args": ["/Users/YOUR_USERNAME/wordpress-boost/bin/wp-boost"]
    }
  }
}

To start using through MCP tools, ensure the path in the config points to the wp-boost executable and then connect via your MCP client (Cursor/VS Code, Claude Code, Windsurf, etc.).

Notes and tips:

• The MCP configuration (.mcp.json) is generated during --init and must be reachable by your MCP client for tool discovery.
• If you move the wordpress-boost clone, update the path in the mcp json accordingly.
• The installed AI guidelines live in the .ai/ directory and can be extended with project-specific rules.
• If you encounter permission issues, verify that the wp-boost script has execute permissions and that PHP can access the WordPress project directory.
• The available tools are organized into sections like Site Information, Hooks Introspection, WordPress Structure, Database Tools, Development Context, Security Tools, ACF/WooCommerce Integrations, Gutenberg Blocks, and Data Generation. Use the exact tool names when querying from your MCP client.
• For debugging, you can run wp-boost --help to see supported options and --version to verify the installed version.