Skip to main content
Glama

wpagent-mcp

An MCP server that lets Claude — or any MCP-compatible client — actually operate a WordPress site: plugins, content, themes, menus, media, users, WooCommerce, Elementor and WP-CLI.

It talks to your site through the free WpAgent bridge plugin over a REST API where every request is signed with HMAC-SHA256. No site credentials are involved, and no data passes through a third-party service: the connection is client → your WordPress, directly.

Install

Nothing to install ahead of time — the config below fetches it on demand.

  1. Install the WpAgent plugin on your WordPress site and activate it.

  2. In the WordPress admin, open WpAgent and generate an API key. Choose the permissions you want the assistant to have; a read-only key is a sound way to start.

  3. Add the server to your MCP client. For Claude Desktop, in claude_desktop_config.json:

{
  "mcpServers": {
    "wpagent": {
      "command": "npx",
      "args": ["-y", "wpagent-mcp"],
      "env": {
        "WP_SITE_URL": "https://your-site.com",
        "WP_API_KEY_ID": "wpaia_xxxxxxxxxxxx",
        "WP_API_SECRET": "the secret shown once when you generated the key"
      }
    }
  }
}

For Claude Code:

claude mcp add wpagent \
  --env WP_SITE_URL=https://your-site.com \
  --env WP_API_KEY_ID=wpaia_xxxxxxxxxxxx \
  --env WP_API_SECRET=... \
  -- npx -y wpagent-mcp

Environment variables

Variable

Required

What it is

WP_SITE_URL

yes

Your site's base URL, no trailing slash

WP_API_KEY_ID

yes

The key id shown in the plugin

WP_API_SECRET

yes

The secret, displayed once at generation

WP_SITE_LABEL

no

A friendly name; defaults to the hostname

Related MCP server: Bridgistic

What it can do

Area

Examples

Plugins

list, search wordpress.org, install, activate, deactivate, update, delete

Content

posts, pages, products, any custom post type, with meta and featured images

Themes

list, search, install, activate, theme mods, custom CSS, logo, colours

WooCommerce

settings, orders, coupons, shipping zones, payment gateways, tax rates, stats

Structure

menus, widgets, sidebars, taxonomies, terms, redirections

Media

browse, upload, delete

Users & comments

list, create, update, moderate

Audit

best-practices check over security, SEO, performance, with auto-fixes

WP-CLI

allowlisted commands, off unless enabled in wp-config.php

What it will not do

The API has no path to arbitrary PHP, no path to your database, and no path to wp-config.php. WP-CLI execution is disabled unless the site owner adds define('WPAIA_ENABLE_WPCLI', true); on the server, and even then only allowlisted commands run — db, eval, eval-file, shell, server, config and package are always refused.

Safety

  • Every request is signed with HMAC-SHA256 and carries a timestamp; requests older than five minutes are rejected.

  • Permissions are per key and checked on every route, so a read-only key stays read-only.

  • Every call is written to an audit log you can read in the WordPress admin.

  • Revoking a key in WordPress takes effect immediately.

Ask the assistant to confirm before destructive actions, and keep a current backup — it can delete content when you tell it to.

  • WpAgent — hosted dashboard built on the same bridge, with a free read-only tier

  • The bridge plugin is GPL-2.0-or-later; this server is MIT.

Licence

MIT © KipDev

Available Tools

58 tools
wp_activate_pluginA

Activate an installed WordPress plugin. You can provide the plugin file path (e.g. "woocommerce/woocommerce.php"), slug (e.g. "woocommerce"), or name.

Inputs: plugin (required).

wp_activate_themeA

Switch the active WordPress theme. Provide the theme slug (directory name).

Inputs: slug (required).

wp_audit_best_practicesA

Audit the WordPress site for best practices. Returns a checklist covering security (SSL, debug mode, file editing, admin user, XML-RPC, spam protection, security plugin), SEO (permalinks, SEO plugin), performance (caching plugin), maintenance (backups, auto-updates, WP/plugin updates), and theme (child theme). Each check includes a status (pass/fail/warning) and whether it can be auto-fixed.

Inputs: no named parameters.

wp_cli_executeA

Execute a WP-CLI command. Deny by default: only allowlisted commands run (cache, comment, core, cron, language, media, menu, option, plugin, post, rewrite, role, sidebar, site, term, theme, transient, user, widget). db, eval, eval-file, shell, server, config and package are refused, as are the --require, --exec, --ssh, --http and --path flags. Quote any value containing shell metacharacters. The feature is off unless the site owner set WPAIA_ENABLE_WPCLI in wp-config.php — call wp_cli_status first. Do NOT include the "wp" prefix (e.g., "plugin list", "cache flush").

Inputs: command (required).

wp_cli_list_commandsA

List the allowlisted WP-CLI commands and their permitted subcommands, plus the refused global flags. Anything absent from the list is refused.

Inputs: no named parameters.

wp_cli_statusA

Check WP-CLI availability. Returns whether the feature is enabled in wp-config.php, whether proc_open is available, the WP-CLI path and version. Call this before any WP-CLI command.

Inputs: no named parameters.

wp_create_contentB

Create a new WordPress post, page, or product. For WooCommerce products, you can set prices, SKU, stock, etc.

Inputs: type (required), title (required), sku, meta, +17 more.

wp_create_userC

Create a new WordPress user with username, email, and optional role/name fields.

Inputs: email (required), username (required), role, password, +3 more.

wp_deactivate_pluginB

Deactivate an active WordPress plugin.

Inputs: plugin (required).

wp_delete_commentB

Permanently delete a comment.

Inputs: id (required).

wp_delete_contentA

Delete a WordPress post, page, or product. By default moves to trash; use force=true to permanently delete.

Inputs: id (required), type (required), force.

wp_delete_mediaB

Delete a media file from the WordPress media library.

Inputs: id (required), force.

wp_delete_optionB

Delete a WordPress option by key.

Inputs: key (required).

wp_delete_pluginA

Delete a WordPress plugin (deactivates it first if active). This permanently removes the plugin files.

Inputs: plugin (required).

wp_elementor_get_pageA

Get the Elementor data for a page/post by its ID. Returns the full element tree (sections > columns > widgets), page settings, and metadata. Use this to understand the current structure before making modifications.

Inputs: id (required).

wp_elementor_list_templatesA

List all saved Elementor templates (sections, pages, headers, footers, etc.).

Inputs: no named parameters.

wp_elementor_statusA

Check if Elementor is active and get its version.

Inputs: no named parameters.

wp_elementor_update_pageA

Update the Elementor data for a page/post. Send the full element tree as JSON. The structure follows Elementor's hierarchy: sections (elType: "section") contain columns (elType: "column") which contain widgets (elType: "widget", widgetType: "heading"|"text-editor"|"image"|etc.). Each element has an "id" (8-char hex), "settings" object, and "elements" array for children. Always read the page first with wp_elementor_get_page to understand the current structure.

Inputs: id (required), elements (required), page_settings.

wp_elementor_widget_typesA

List all available Elementor widget types with their names, titles, icons, and categories. Use this to know which widgets you can use when building pages.

Inputs: no named parameters.

wp_fix_best_practicesA

Apply auto-fixes for best practice issues. Currently supports fixing: "permalinks" (sets to /%postname%/) and "xmlrpc" (disables via mu-plugin). Pass an array of fix IDs to apply.

Inputs: fixes (required).

wp_get_commentA

Get a single comment with full details by its ID.

Inputs: id (required).

wp_get_contentA

Get a single WordPress content item by ID with full details including content, meta fields, categories, tags, and WooCommerce product data if applicable.

Inputs: id (required), type (required).

wp_get_mediaA

Get detailed information about a single media file including all available sizes and URLs.

Inputs: id (required).

wp_get_optionA

Get a single WordPress option value by key. Common options: blogname, blogdescription, timezone_string, date_format, time_format, permalink_structure, posts_per_page, etc.

Inputs: key (required).

wp_get_options_batchB

Get multiple WordPress options at once. Provide a comma-separated list of option keys.

Inputs: keys (required).

wp_get_userB

Get detailed information about a specific WordPress user by ID.

Inputs: id (required).

wp_install_pluginA

Install a plugin from the WordPress.org repository by its slug. Optionally activate it immediately after installation.

Inputs: slug (required), activate.

wp_install_themeA

Install a theme from WordPress.org by its slug. Optionally activate it after installation.

Inputs: slug (required), activate.

wp_list_commentsB

List comments with optional filtering by status (approve, hold, spam, trash, all), post ID, and search.

Inputs: page, search, status, post_id, +1 more.

wp_list_contentA

List WordPress content (posts, pages, products, or any custom post type). Supports search, pagination, and filtering by status.

Inputs: type (required), page, order, search, +4 more.

wp_list_mediaB

List media files in the WordPress media library. Can filter by MIME type (image/jpeg, video/mp4, etc.) and search by name.

Inputs: page, search, per_page, mime_type.

wp_list_pluginsA

List all installed WordPress plugins with their status (active/inactive), version, and update availability.

Inputs: no named parameters.

wp_list_themesA

List all installed WordPress themes with their status (active/inactive), version, and parent theme info.

Inputs: no named parameters.

wp_list_usersB

List WordPress users with optional filtering by role, search query, and pagination.

Inputs: page, role, order, search, +2 more.

wp_reply_commentA

Reply to a comment as the site administrator.

Inputs: content (required), post_id (required), parent_id (required).

wp_search_pluginsA

Search the WordPress.org plugin directory. Use this to find plugins by name or keyword before installing them.

Inputs: query (required), per_page.

wp_search_themesA

Search the WordPress.org theme directory for themes matching a query.

Inputs: query (required), per_page.

wp_set_optionsA

Set one or more WordPress options. Provide an object of key-value pairs. Note: some sensitive options (siteurl, admin_email, etc.) are blocked for security.

Inputs: options (required).

wp_site_healthA

Check if the WordPress site is reachable and the WP AI Assistant plugin is active.

Inputs: no named parameters.

wp_site_infoA

Get comprehensive WordPress site information including version, plugins, theme, post types, WooCommerce status, and server details.

Inputs: no named parameters.

wp_update_comment_statusA

Change a comment status: approve, hold (unapprove), spam, or trash.

Inputs: id (required), status (required).

wp_update_contentA

Update an existing WordPress post, page, or product. Only provide the fields you want to change.

Inputs: id (required), type (required), sku, meta, +11 more.

wp_update_pluginA

Update a WordPress plugin to the latest version from WordPress.org.

Inputs: plugin (required).

wp_update_userB

Update an existing WordPress user (email, role, name fields).

Inputs: id (required), role, email, last_name, +2 more.

wp_upload_mediaA

Upload a file to the WordPress media library using base64-encoded data. Maximum file size: 10MB.

Inputs: data (required), filename (required), alt, title.

wp_woocommerce_create_couponB

Create a new WooCommerce coupon with discount rules.

Inputs: code (required), amount (required), expiry_date, product_ids, +6 more.

wp_woocommerce_create_tax_rateB

Create a new WooCommerce tax rate for a specific country/state.

Inputs: name (required), rate (required), country (required), state, +3 more.

wp_woocommerce_get_orderA

Get full details of a single WooCommerce order including line items, billing/shipping addresses, and payment info.

Inputs: id (required).

wp_woocommerce_get_settingsA

Get WooCommerce settings by group. Available groups: "general" (store address, currency), "products" (weights, stock), "shipping", "checkout" (guest checkout, etc.), "emails".

Inputs: group.

wp_woocommerce_list_couponsB

List all WooCommerce coupons with their discount types, amounts, and usage stats.

Inputs: per_page.

wp_woocommerce_list_ordersA

List WooCommerce orders with customer info, totals, and status. Supports filtering by status and pagination.

Inputs: page, status, per_page.

wp_woocommerce_list_tax_ratesA

List all WooCommerce tax rates configured on the site.

Inputs: no named parameters.

wp_woocommerce_payment_gatewaysA

List all available WooCommerce payment gateways with their enabled/disabled status.

Inputs: no named parameters.

wp_woocommerce_shipping_zonesA

List WooCommerce shipping zones with their configured shipping methods.

Inputs: no named parameters.

wp_woocommerce_statsA

Get WooCommerce sales statistics for a given period: total revenue, order count, average order value, and customer count.

Inputs: period.

wp_woocommerce_statusA

Check if WooCommerce is installed and active. Returns store details: currency, address, product/order counts, and enabled features.

Inputs: no named parameters.

wp_woocommerce_update_payment_gatewayC

Enable/disable or configure a WooCommerce payment gateway.

Inputs: id (required), title, enabled, options, +1 more.

wp_woocommerce_update_settingsB

Update WooCommerce settings. Provide key-value pairs of woocommerce_ prefixed options. For example: {"woocommerce_currency": "EUR", "woocommerce_default_country": "FR"}.

Inputs: settings (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 58 tools

    Disambiguation4/5

    Most tools follow a clear resource+action split (plugin, content, order, comment, media, user), but a few overlap: wp_site_info vs wp_site_health, wp_get_content vs wp_elementor_get_page, and wp_cli_execute can replicate many dedicated tools. Descriptions generally prevent misselection.

    Naming Consistency4/5

    The overwhelming pattern is wp_<domain>_<verb>_<noun> in snake_case, which is predictable and easy to navigate. Deviations include noun-only names like wp_woocommerce_shipping_zones, wp_woocommerce_payment_gateways, and wp_elementor_widget_types, plus nominal names like wp_site_info and wp_site_health.

    Tool Count2/5

    With 58 tools, this is far beyond the typical well-scoped MCP surface and creates a large namespace for an agent to navigate. While each subdomain is heavily covered, the count is excessive for a single server and many tools could be consolidated or exposed as subcommands.

    Completeness3/5

    The server covers a broad range of domains with solid CRUD cycles for content, plugins, media, options, and comments. However, notable lifecycle gaps remain: themes have no update/delete, WooCommerce coupons and tax rates have no update/delete, and users have no delete operation.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Production MCP server that runs as a WordPress plugin, exposing 40+ tools for managing posts, pages, custom post types, WooCommerce products, media, users, and menus from any MCP client. Includes API key + OAuth 2.0 authentication, rate limiting (60 req/min per IP), and activity logging. Free on WordPress.org
      10
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Manages WordPress sites over the REST API, enabling users, posts/pages, media, ACF fields, and Elementor page operations through MCP-compatible clients.
      MIT