WordPress MCP - AI Agent Access

WordPress 6.9+ required. MCP requires WordPress 6.9 or later. All BionicWP-hosted sites meet this requirement automatically.

Plugin renamed. The abilities plugin is now called Site Manager MCP Abilities (previously BionicWP MCP Abilities). You'll see this name in your Plugins list in wp-admin. Functionality and the bwp/ ability prefix are unchanged.

Note: Installation typically takes 10–20 seconds. Do not refresh the page during this process.

Important: Disabling MCP removes both plugins completely from the site. Any AI agent configs pointing to this site will stop working immediately.

Important: You will not be able to view this password again after leaving the page. Store it somewhere safe, such as a password manager.

{

  "mcpServers": {

    "yoursite": {

      "command": "npx",

      "args": [

        "-y",

        "@automattic/mcp-wordpress-remote@latest"

      ],

      "env": {

        "WP_API_URL": "https://yoursite.com/wp-json/mcp/mcp-adapter-default-server",

        "WP_API_USERNAME": "your_username",

        "WP_API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"

      }

    }

  }

}

Windows users: If you use Claude Desktop on Windows, use npx.cmd instead of npx in the command field of the config.

bwp/get-posts

List or search posts with filters (status, category, author, pagination)

WordPress core

bwp/create-post

Create a new post with title, content, status, categories, tags, and meta

WordPress core

bwp/update-post

Update an existing post's content, status, categories, tags, or meta

WordPress core

bwp/delete-post

Move a post to trash or permanently delete it

WordPress core

bwp/get-post

Get a single post or page's raw editor content, plus which page builder (if any) it uses. Always called before editing.

WordPress core

bwp/search-posts

Search posts and pages by keyword, or look up by exact slug, to find the right post before reading or editing it.

WordPress core

bwp/edit-post-content

Make a targeted edit (find-and-replace, or add content before/after/at the start/end) instead of replacing the whole post. A safe restore point is saved automatically before the edit is made.

WordPress core

bwp/get-post-revisions

List a post's saved revisions — these are the restore points used to undo an edit.

WordPress core

bwp/restore-revision

Roll a post or page back to a previous revision.

WordPress core

bwp/get-post-diff

Compare two versions of a post's content (for example, before and after an edit) and get a readable diff instead of two full copies of the content.

WordPress core

bwp/duplicate-post

Clone a post or page as a draft, including its content, categories/tags, featured image, and Elementor data. Useful for testing an edit safely before publishing.

WordPress core

bwp/set-featured-image

Set or remove a post or page's featured image, from an image already in the media library.

WordPress core

bwp/get-elementor-data

List every element on an Elementor page (with a short label for each), or get the full settings for one specific element.

Elementor

bwp/update-elementor-widget

Update the settings of a single Elementor element — a heading, a button, an image, and so on — without touching the rest of the page. A backup of the previous version is saved automatically.

Elementor

bwp/restore-elementor-backup

Undo the most recent bwp/update-elementor-widget edit on a post. Only the single most recent edit can be undone this way.

Elementor

bwp/get-divi-blocks

List the structure of a Divi 5 page — every section, row, column, and module, with a short label for each.

Divi 5

bwp/update-divi-block

Update a single Divi 5 block (for example, one module's text) without replacing the whole page. A safe restore point is saved automatically before the edit is made.

Divi 5

bwp/get-pages

List pages with status, parent, and search filters

WordPress core

bwp/create-page

Create a new page with title, content, parent, and meta

WordPress core

bwp/update-page

Update an existing page's content, status, or parent

WordPress core

bwp/delete-page

Move a page to trash or permanently delete it

WordPress core

bwp/get-media

List media library items with search and mime type filters

WordPress core

bwp/upload-media

Upload a file to the media library from a remote URL

WordPress core

bwp/get-categories

List all post categories

WordPress core

bwp/create-category

Create a new category with name, slug, parent

WordPress core

bwp/update-category

Update an existing category

WordPress core

bwp/delete-category

Delete a post category

WordPress core

bwp/get-tags

List all post tags

WordPress core

bwp/create-tag

Create a new tag

WordPress core

bwp/delete-tag

Delete a tag

WordPress core

bwp/get-menus

List all registered menus and their items

WordPress core

bwp/add-menu-item

Add an item to a navigation menu

WordPress core

bwp/delete-menu-item

Remove an item from a navigation menu

WordPress core

bwp/get-users

List users with optional role and search filters

WordPress core

bwp/create-user

Create a new user with username, email, password, and role

WordPress core

bwp/update-user

Update a user's email, display name, role, or password

WordPress core

bwp/get-comments

List comments filtered by status (pending, approved, spam)

WordPress core

bwp/moderate-comment

Approve, unapprove, trash, spam, or delete a comment

WordPress cor

bwp/get-seo-meta

Read Yoast or RankMath SEO title, meta description, and focus keyword for a post

Yoast SEO or RankMath

bwp/update-seo-meta

Write Yoast or RankMath SEO fields for a post or page

Yoast SEO or RankMath

bwp/get-post-meta

Read post meta fields — useful for Divi, WPBakery, or custom fields

WordPress core

bwp/update-post-meta

Write post meta fields — covers Divi, WPBakery, ACF, and custom fields

WordPress core

bwp/get-acf-fields

Get all ACF field values for a post or page

ACF plugin

bwp/update-acf-fields

Update ACF field values for a post or page

ACF plugin

bwp/get-acf-field-groups

List all registered ACF field group definitions

ACF plugin

bwp/get-products

List or search products with status, category, and pagination filters

WooCommerce

bwp/create-product

Create a simple product with price, SKU, stock, and categories

WooCommerce

bwp/update-product

Update an existing product's price, stock, status, or details

WooCommerce

bwp/delete-product

Trash or permanently delete a product

WooCommerce

bwp/get-product-categories

List WooCommerce product categories

WooCommerce

bwp/create-product-category

Create a new product category

WooCommerce

bwp/get-orders

List orders with status, customer, and pagination filters

WooCommerce

bwp/get-order

Get full detail for a single order, including its line items (new)

WooCommerce

bwp/update-order

Update order status or add a note (optionally notify customer)

WooCommerce

bwp/create-coupon

Create a percent or fixed discount coupon with expiry and limits

WooCommerce

bwp/get-site-settings

Read site title, tagline, URL, admin email, timezone, theme, and WordPress version

WordPress core

bwp/update-site-settings

Update site title, tagline, admin email, timezone, date format, or posts per page

WordPress core

bwp/list-plugins

List all installed plugins with name, version, and active status

WordPress core

bwp/activate-plugin

Activate an installed plugin by its plugin file path

WordPress core

bwp/deactivate-plugin

Deactivate an active plugin

WordPress core

bwp/install-plugin

Install a plugin from the WordPress.org repository by slug

WordPress core

bwp/update-plugin

Update an installed plugin to its latest available version

WordPress core

bwp/list-updates

Check for available updates for plugins, themes, and WordPress core

WordPress core

bwp/get-site-health

Run WordPress Site Health checks and return results grouped by severity

WordPress core

bwp/get-cache-status

Report which caching plugins are actively integrated with bwp/clear-cache, which other active plugins look cache-related but aren't yet, and whether an external object cache is in use

WordPress core

bwp/clear-cache

Flush the object cache and trigger a full cache purge for WP Rocket, LiteSpeed, Autoptimize, and Cache Engine

WordPress core

bwp/clear-cache-url

Purge the cache for a single URL or path instead of the whole site (new — Cache Engine sites only)

Cache Engine

<?php

// Step 1: Register a category (once per plugin)
add_action( 'wp_abilities_api_categories_init', function() {
    wp_register_ability_category( 'my-plugin', [
        'label'       => 'My Plugin',
        'description' => 'Custom abilities for my plugin.',
    ]);
});

// Step 2: Register your ability
add_action( 'wp_abilities_api_init', function() {
    wp_register_ability( 'my-plugin/do-something', [
        'label'               => 'Do Something',
        'description'         => 'Performs a custom action.',
        'category'            => 'my-plugin',
        'input_schema'        => [
            'type'       => 'object',
            'properties' => [
                'message' => [ 'type' => 'string' ],
            ],
            'required'   => [ 'message' ],
        ],
        'output_schema'       => [
            'type'       => 'object',
            'properties' => [
                'result' => [ 'type' => 'string' ],
            ],
        ],
        'execute_callback'    => function( $input ) {
            return [ 'result' => 'You said: ' . $input['message'] ];
        },
        'permission_callback' => function() {
            return current_user_can( 'manage_options' );
        },
        'meta'                => [
            'mcp' => [ 'public' => true, 'type' => 'tool' ],
        ],
    ]);
});

'execute_callback' => function( $input ) {
    $post = get_post( $input['post_id'] );

    if ( ! $post ) {
        return new WP_Error( 'not_found', 'Post not found.' );
    }

    return [ 'title' => $post->post_title ];
},

'execute_callback' => function( $input ) {

    if ( ! function_exists( 'wc_get_product' ) ) {

        return new WP_Error( 'woocommerce_missing', 'WooCommerce is not active.' );

    }

    // Your WooCommerce logic here

},

<?php

/**

 * Plugin Name: My Custom MCP Abilities

 * Description: Custom MCP abilities for my site.

 * Version: 1.0.0

 */

if ( ! defined( 'ABSPATH' ) ) exit;

add_action( 'wp_abilities_api_categories_init', function() {

    wp_register_ability_category( 'my-site', [

        'label'       => 'My Site',

        'description' => 'Custom abilities for my site.',

    ]);

});

add_action( 'wp_abilities_api_init', function() {

    // Register your abilities here

})

Need help building custom abilities? Contact BionicWP support for more examples and advanced patterns.