mcp-for-woocommerce by iOSDevSK - MCP Server

MCP for WooCommerce

Connect your WooCommerce store to AI assistants like Claude and VS Code. This WordPress plugin enables AI clients to access your store's product catalog, categories, reviews, and content through a secure, read-only interface.

Community Plugin Notice: This is a community-developed plugin and is not affiliated with or endorsed by Automattic, the creators of WordPress and WooCommerce. While it builds upon the foundation of the official WordPress MCP implementation, this plugin is independently maintained.

MCP for WooCommerce transforms your WordPress site into an AI-accessible data source built on Automattic's official WordPress MCP. It safely exposes public store information—products, categories, tags, reviews, shipping options, and WordPress content—while protecting customer data and private details.

Perfect for building AI-powered shopping assistants or integrating with custom AI applications.

Key Features

Read-only access: all tools are type "read" (no writes)
Product/variation permalinks: every product/variation includes a permalink field (must be shown in AI responses)
Dual transports: STDIO (WordPress style) and Streamable HTTP (JSON-RPC 2.0)
JWT authentication: secure token access, with optional local-development mode
Admin UI: settings page with tool toggles and automated proxy generation for Claude Desktop when JWT is disabled
WooCommerce focus: intelligent search, categories, tags, attributes, reviews, shipping, payments, taxes, system status
WordPress content: posts and pages with permalinks

Why Choose MCP for WooCommerce

WooCommerce MCP Server: turnkey MCP server for WooCommerce + WordPress.
WordPress MCP Plugin: install, toggle tools, authenticate, and connect any MCP client.
AI Chatbot/Agent: integrate with chat platforms to deploy on-site assistance in minutes.
Read-only and safe: no PII; tools return permalinks for clickable product links.
Works with Claude, VS Code MCP, MCP Inspector, custom MCP clients.

Architecture and Endpoints

STDIO transport (WordPress format)
- Endpoint: /wp-json/wp/v2/wpmcp
- Auth: JWT if required, or unauthenticated read-only if JWT is disabled in settings
- Usage: broad client compatibility via @automattic/mcp-wordpress-remote proxy
Streamable HTTP transport (JSON-RPC 2.0)
- Endpoint: /wp-json/wp/v2/wpmcp/streamable
- Auth: JWT (recommended for direct integration)
- Benefits: lower latency, no proxy needed, modern MCP
- OpenAPI: /wp-json/wp/v2/wpmcp/openapi.json

Tip: If you’re searching for “WooCommerce MCP Server endpoint”, this is it. Use the Streamable HTTP transport for modern, low-latency clients.

Requirements

WordPress 6.4+
PHP 8.0+
WooCommerce activated
Node.js (admin UI build), Composer (development)

Installation

WordPress Admin (recommended)

Download the latest release, upload ZIP via Plugins > Add New > Upload
Activate the plugin

Manual

Upload ZIP to wp-content/plugins/
Extract and activate in Plugins

Development install

cd wp-content/plugins/
git clone https://github.com/Automattic/wordpress-mcp.git mcp-for-woocommerce
cd mcp-for-woocommerce
composer install
npm install && npm run build

AI Shopping Assistant

Deploy AI-powered customer assistance on your site using the MCP data interface.

Benefits:

Direct WooCommerce data access via standardized tools
Secure authentication with JWT tokens
Product information with clickable links
Compatible with various AI platforms

Setup process:

Configure your AI platform to use the MCP endpoint
Copy a JWT token from WordPress Admin → Settings → MCP for WooCommerce → Tokens
Deploy your chosen chat interface or assistant

Result: an AI assistant connected to your catalog that can answer questions with product links and variations.

Documentation Site

Browse the documentation site (after GitHub Pages is enabled): https://iosdevsk.github.io/mcp-for-woocommerce/
Quick links:
- What is WooCommerce MCP Server? docs/woocommerce-mcp-server/what-is.md
- Install: docs/woocommerce-mcp-server/install.md
- Configure: docs/woocommerce-mcp-server/configure.md
- Examples: docs/woocommerce-mcp-server/examples.md
- Troubleshooting: docs/woocommerce-mcp-server/troubleshooting.md
- FAQ: docs/woocommerce-mcp-server/faq.md

Admin Settings

Location: Settings > MCP for WooCommerce
Core toggles:
- Enable MCP functionality: master on/off for the plugin
- Require JWT Authentication: enforce JWT for MCP endpoints
  - When disabled, the plugin can act as a local Claude Desktop connector. It automatically generates a proxy script file.
Tools: enable/disable individual tools (states stored in the wordpress_mcp_tool_states option)

Note: The settings page is a React UI (assets in build/).

Authentication and Clients

JWT tokens
- Generate/manage from the admin UI (Authentication Tokens)
- Best practice: rotate tokens, use short expirations for production
Claude Code (direct HTTP + JWT)

claude mcp add --transport http \
  mcp-for-woocommerce https://your-site.com/wp-json/wp/v2/wpmcp/streamable \
  --header "Authorization: Bearer YOUR_JWT"

Claude Desktop via proxy (recommended for STDIO)

{
  "mcpServers": {
    "mcp-for-woocommerce": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://your-site.com",
        "JWT_TOKEN": "YOUR_JWT"
      }
    }
  }
}

VS Code MCP Extension (direct Streamable + JWT)

{
  "servers": {
    "mcp-for-woocommerce": {
      "type": "http",
      "url": "https://your-site.com/wp-json/wp/v2/wpmcp/streamable",
      "headers": { "Authorization": "Bearer YOUR_JWT" }
    }
  }
}

MCP Inspector (testing)

npx @modelcontextprotocol/inspector \
  -e WP_API_URL=https://your-site.com \
  -e JWT_TOKEN=YOUR_JWT \
  npx @automattic/mcp-wordpress-remote@latest

Automatic local proxy generation (when JWT is disabled)

When you toggle “Require JWT Authentication” OFF in Settings > MCP for WooCommerce, the plugin automatically generates a Claude Desktop-friendly MCP proxy script at:
- wp-content/plugins/mcp-for-woocommerce/mcp-proxy.js (executable, Node.js)
The UI also surfaces ready-to-copy Claude Desktop config JSON. Additionally, a PHP proxy file ships with the plugin (mcp-proxy.php) if you prefer PHP:

// Node (uses generated mcp-proxy.js)
{
  "mcpServers": {
    "woocommerce": {
      "command": "node",
      "args": ["/wp-content/plugins/mcp-for-woocommerce/mcp-proxy.js"]
    }
  }
}

// PHP (ships with the plugin)
{
  "mcpServers": {
    "woocommerce": {
      "command": "php",
      "args": ["/wp-content/plugins/mcp-for-woocommerce/mcp-proxy.php"]
    }
  }
}

Best-Practice Product Search Workflow

Use wc_products_search first to find products by name/description
Use wc_get_product with the returned ID for details
Use wc_get_product_variations (or wc_get_product_variation) for variations
Always include clickable permalink links for products and variations

Registered Tools (read-only)

Products & search
- wc_products_search — primary universal search (includes permalink)
- wc_get_product — product by ID (includes permalink)
- wc_get_product_variations — all variations for a variable product (each includes permalink)
- wc_get_product_variation — specific variation by ID (includes permalink)
- wc_intelligent_search — intelligent fallback multi-stage search
- wc_analyze_search_intent — analyze user query and suggest parameters
- wc_analyze_search_intent_helper — helper for categories/tags mapping
- wc_get_products_by_brand — products by brand (attribute/category/custom taxonomy)
- wc_get_products_by_category — products by category
- wc_get_products_by_attributes — products filtered by attributes
- wc_get_products_filtered — multi-criteria filtering (brand/category/price/attributes)
Categories, tags, attributes
- wc_get_categories — list product categories
- wc_get_tags — list product tags
- wc_get_product_attributes — global attribute definitions
- wc_get_product_attribute — attribute by ID
- wc_get_attribute_terms — attribute terms (e.g., Red, Blue for Color)
Reviews
- wc_get_product_reviews — list reviews with filters/pagination
- wc_get_product_review — single review by ID
Shipping & payments
- wc_get_shipping_zones, wc_get_shipping_zone
- wc_get_shipping_methods, wc_get_shipping_locations
- wc_get_payment_gateways, wc_get_payment_gateway
Taxes & system
- wc_get_tax_classes, wc_get_tax_rates
- wc_get_system_status, wc_get_system_tools
WordPress content
- wordpress_posts_list, wordpress_posts_get
- wordpress_pages_list, wordpress_pages_get

Notes:

Tools are defined under includes/Tools/* and gated by WooCommerce where applicable.
Some analytics/report helpers are available as REST aliases (read-only).

Integration Examples

Connect various AI platforms to your WooCommerce data.

Prerequisites:

MCP for WooCommerce installed and enabled
JWT token generated in WordPress Admin (Settings > MCP for WooCommerce)
Your chosen AI platform or chatbot service

Common integration patterns:

API Endpoint Integration:

Use streamable endpoint: /wp-json/wp/v2/wpmcp/streamable
Include JWT token in Authorization header
Follow JSON-RPC 2.0 protocol for requests

Chat Platform Setup:

Configure platform to use MCP endpoint
Provide your WordPress site URL
Authenticate with generated JWT token
Example platforms: Webtalkbot, custom chatbots, AI assistants

Best practices:

Test with common customer questions
Ensure product links are included in responses
Monitor API usage and performance
Keep JWT tokens secure and rotate regularly

Security

JWT: signature validation, expiration, easy rotation
JWT disabled mode: read-only access plus a generated local proxy script for Claude Desktop
Never commit tokens; use HTTPS; rotate frequently
Tool toggles: disable tools you don’t want exposed
No customer PII is exposed; focus is on public store data and WP content

Troubleshooting

“WooCommerce functions not available”: ensure WooCommerce is active
“Insufficient permissions”: with JWT required, admin capabilities are needed (e.g., manage_woocommerce)
wc_intelligent_search returns no products: the tool suggests alternatives; try a less restrictive query
Admin UI issues: run npm install && npm run build in the plugin directory

Developer Notes

Structure (selection):

includes/
  Core/ (McpStdioTransport, McpStreamableTransport, WpMcp, …)
  Admin/ (Settings.php — settings, JWT toggle, tool toggles, proxy generation)
  Tools/ (McpWooProducts, McpWooIntelligentSearch, McpWoo*, …)
  Resources/
src/ (React UI for settings)

Build UI:

npm install
npm run build

Run tests:

vendor/bin/phpunit

Changelog

Full changelog: changelog.txt and the “Changelog” page in the docs (synced from GitHub)

License

This project is licensed under the GPL v2 or later. See the LICENSE file for details.

AI Assistant Tips (best practice):

Always start with wc_products_search, then wc_get_product for details
Never hardcode product IDs; use IDs returned from search
Always include clickable permalink links in user-facing answers

Frequently Asked Questions

What is a WooCommerce MCP Server?

A server implementation of the Model Context Protocol that exposes WooCommerce and WordPress data to MCP clients (e.g., Claude, VS Code MCP). MCP for WooCommerce is a WordPress plugin that acts as that server.

How do I install the plugin?

Upload and activate the plugin, run composer install and npm run build for development installs, then configure settings in WordPress Admin → Settings → MCP for WooCommerce.

How do I connect Claude or VS Code?

Use the Streamable endpoint /wp-json/wp/v2/wpmcp/streamable with a JWT header. Examples are in the "Authentication and Clients" section.

Can I add an AI Chatbot to my website?

Yes. Use the MCP interface to connect your store data with AI chatbot platforms. Create a JWT token in MCP for WooCommerce settings and configure your chosen AI platform to use the provided endpoints.

Is this read-only? Does it include product links?

Yes, all tools are read-only and include permalink fields for products/variations, ideal for customer-facing answers.

Is customer/order data exposed?

No. The plugin focuses on public store/catalog data and WordPress content. No PII is exposed.

Is this compatible with Automattic's WordPress MCP?

Yes, this community plugin builds upon and extends Automattic's official WordPress MCP implementation. However, this plugin is independently developed and maintained by the community - it is not affiliated with or endorsed by Automattic. It follows the same GPL-2.0-or-later license.