# WooCommerce

WordPress commerce plugin with native MCP abilities for products and orders (developer preview).

The WordPress e-commerce plugin. WooCommerce now registers purpose-built abilities (query, create, update, delete products; query orders, update status, add notes) that the bundled WordPress MCP Adapter exposes as MCP tools behind the mcp_integration feature flag. Everything else remains on the REST API v3. GPL-3.0 with paid extensions.

Alternative to: Shopify, BigCommerce

- Capabilities: adaptable, operable
- Vertical: ecommerce
- Shape: business-app
- Form factor: web-app
- Execution model: deterministic
- Provenance: human-written (recorded, never ranked)
- Repo: https://github.com/woocommerce/woocommerce (GPL-3.0), 10484 stars, last commit 2026-09-02
- Last activity: 2026-09-02
- Page: apps/woocommerce--woocommerce.html
- JSON: apps/woocommerce--woocommerce.json

## Use it when

- I already run WordPress and want my agent to list, create, and update products and move orders along
- I need the largest extension ecosystem and accept GPL and PHP

## Gotchas

- MCP integration is a developer preview behind the mcp_integration feature flag; APIs may change
- Order and customer tools expose PII; the docs tell you to use least-privilege keys
- Requires a local proxy (mcp-wordpress-remote) for stdio clients
- GPL-3.0 core; some Adopters cannot accept copyleft

## Editions

- WooCommerce plugin: Free, open source
  - source: https://github.com/woocommerce/woocommerce
  - installable: wp plugin install woocommerce --activate
- Paid extensions: Free, closed source
  - hosted: https://woocommerce.com/products/

## Adaptable: make it yours

Effort: light-edit (2 things to edit)

Store settings, payments, shipping, and tax are set in wp-admin. Code adaptation is hooks and filters in a child theme or a small plugin, and constants in wp-config.php. MCP needs the mcp_integration feature flag enabled and a REST API key (deprecated endpoint) or the MCP Adapter's auth. GPL-3.0 applies to derived PHP.

- Env vars: none
- Config files: wp-config.php, functions.php (child theme)
- Prompt files: none
- Accounts you'll need: WordPress site with admin access; WooCommerce.com (paid extensions, optional)

## Operable: what an agent can drive

Operability: official. Interface: mcp at https://github.com/woocommerce/woocommerce/blob/trunk/docs/features/mcp/README.md (published by the builder, local).

### Reach (partial coverage)

- Query, create, update, delete products: reachable. docs/features/mcp/README.md: purpose-built product abilities
- Query orders, update status, add notes: reachable. docs/features/mcp/README.md: order abilities
- Create orders: reachable. deprecated /wp-json/woocommerce/mcp endpoint exposes REST-derived order create
- Manage customers: not reachable. not among the registered abilities; REST API v3 /customers
- Coupons and promotions: not reachable. not among abilities; REST API v3 /coupons
- Refunds: not reachable. not among abilities; REST API v3
- Reports and analytics: not reachable. not among abilities; REST API v3 /reports
- Shipping, tax, and store settings: not reachable. not among abilities; REST API v3 /settings
- Storefront checkout: not reachable. Store API is a separate browser-facing API

## Code stack

- Languages: PHP, JavaScript, TypeScript
- Frameworks: WordPress, React (blocks)
- Package manager: pnpm
- Database: MySQL
- Hosting target: any WordPress host, WooCommerce hosting partners

## Skills

contributor: Repo tooling for WooCommerce contributors: dev cycle, local env, code review, commit and PR hygiene.
- Paths: .ai/skills/*/SKILL.md

## Evidence and confidence

- formFactor: WordPress plugin that renders the store; listed as web-app for the Adopter's view (confidence 0.7)
- executionModel: no model at runtime (confidence 0.95)
- operability: abilities registered in plugins/woocommerce/src/Internal/Abilities; docs/features/mcp/README.md in the WooCommerce repo (confidence 0.85)
- effort: hooks, filters, wp-config documented by WooCommerce; no env surface (confidence 0.7)
- editions: license.txt GPL-3.0; woocommerce.com marketplace (confidence 0.8)
- active: pushedAt 2026-09-02
- reach:  (confidence 0.85)

## Open questions

- Exact ability names surfaced as MCP tools
- Whether more abilities (customers, coupons) are planned before the preview ends

## Sources

- https://github.com/woocommerce/woocommerce (sourcing:ecommerce:github)
- https://github.com/WordPress/mcp-adapter (sourcing:ecommerce:github)
- https://github.com/woocommerce/woocommerce/blob/trunk/docs/features/mcp/README.md (analysis)