WooCommerce MCP Ability Demo Plugin

⚠️ DEMO TOOL - NOT PRODUCTION READY ⚠️

This is a demonstration plugin showing how third-party developers can integrate with the WordPress MCP (Model Context Protocol) server by registering custom WooCommerce abilities using the WordPress Abilities API. This plugin is for educational and testing purposes only and should not be used in production environments.

Overview

This plugin demonstrates the integration between:

• WordPress Abilities API - A standardized way to register capabilities in WordPress
• WordPress MCP Adapter - Exposes abilities through a shared MCP server when installed as a separate plugin

Important Notice: The MCP integration in WooCommerce is a developer preview. Implementation details, APIs, and integration patterns may change in future releases. This demo is designed to showcase current capabilities and may require updates as the feature matures.

The demo creates a custom ability that retrieves WooCommerce store information and statistics, showcasing how external plugins can extend the MCP server’s capabilities.

Requirements

• WordPress 7.0 or higher (includes the Abilities API)
• PHP 8.0 or higher
• WooCommerce 11.3 or higher
• MCP Adapter plugin for MCP access (not bundled with WooCommerce)

Installation

1. Clone or download this repository to your WordPress plugins directory:

   cd wp-content/plugins/
   git clone https://github.com/woocommerce/wc-mcp-ability.git wc-mcp-ability
   

2. Activate the plugin through the WordPress admin dashboard or WP-CLI:

   wp plugin activate wc-mcp-ability
   

3. Install and activate the MCP Adapter to expose the ability to MCP clients:

   wp plugin install mcp-adapter --activate
   

What This Demo Does

The plugin registers a custom ability called woocommerce-demo/store-info that:

Functionality

• Retrieves basic store information (name, URL, admin email, versions)
• Optionally includes store statistics (product count, order counts by status, customer count)
• Demonstrates proper schema definition for inputs and outputs
• Shows permission handling for MCP abilities

Technical Implementation

• Ability Registration: Uses wp_register_ability() from the WordPress Abilities API
• MCP Integration: Registers a category and uses meta.mcp.public to expose the ability through the shared WordPress MCP Adapter
• Permission Control: Requires manage_woocommerce capability for access
• Schema Definition: Provides complete JSON schema for both input parameters and output structure

Usage Example