Skip to main content

Tools Reference

Complete catalog of all 159 MCP tools available in the WooCommerce MCP Server, organized by domain category.

Overview

The WooCommerce MCP Server exposes 159 tools covering the full WooCommerce and WordPress REST API surface. Tools are organized into the following categories:

CategoryToolsDescription
WordPress Content3Post creation, listing, and updates
Post Metadata4Read, create, update, and delete post meta
Products6Product CRUD operations
Product Variations5Variable product variant management
Product Attributes5Global product attribute definitions
Attribute Terms5Terms within product attributes
Product Categories5Category hierarchy management
Product Tags5Product tag management
Product Reviews5Customer review management
Product Metadata4Product-level custom metadata
Orders5Order lifecycle management
Order Notes4Internal and customer-facing order notes
Order Refunds4Refund processing and management
Order Metadata4Order-level custom metadata
Customers5Customer account management
Customer Metadata4Customer-level custom metadata
Shipping Zones5Shipping zone configuration
Shipping Methods5Zone-specific shipping method management
Shipping Zone Locations2Geographic location assignments
Taxes8Tax classes and rate management
Coupons5Discount coupon management
Payment Gateways3Payment gateway configuration
Reports8Sales, inventory, and analytics reports
Settings3Store settings management
System Status3Diagnostics and system tools
Data5Geographic and currency reference data

WordPress Content

Tools for managing WordPress posts via the REST API. Requires WORDPRESS_USERNAME and WORDPRESS_PASSWORD environment variables.

ToolDescription
create_postCreate a new WordPress post
get_postsGet a list of WordPress posts
update_postUpdate an existing WordPress post

Post Metadata

Manage custom metadata fields attached to WordPress posts.

ToolDescription
get_post_metaGet meta data for a WordPress post
create_post_metaCreate meta data for a WordPress post
update_post_metaUpdate meta data for a WordPress post
delete_post_metaDelete meta data from a WordPress post

Products

Core product management tools. The get_products, get_product, and search_products tools are also available on the public endpoint (with sanitized responses).

ToolDescription
get_productsGet a list of WooCommerce products
get_productGet a single WooCommerce product by ID
search_productsSearch WooCommerce products by keyword, category, tag, or price range
create_productCreate a new WooCommerce product
update_productUpdate an existing WooCommerce product
delete_productDelete a WooCommerce product

Product Variations

Manage variations for variable products (e.g., size/color combinations).

ToolDescription
get_product_variationsGet variations for a WooCommerce product
get_product_variationGet a single product variation
create_product_variationCreate a product variation
update_product_variationUpdate a product variation
delete_product_variationDelete a product variation

Product Attributes

Manage global product attributes (e.g., Color, Size, Material) used across products.

ToolDescription
get_product_attributesGet all product attributes
get_product_attributeGet a single product attribute
create_product_attributeCreate a product attribute
update_product_attributeUpdate a product attribute
delete_product_attributeDelete a product attribute

Attribute Terms

Manage individual terms within a product attribute (e.g., "Red", "Blue" within "Color").

ToolDescription
get_attribute_termsGet terms for a product attribute
get_attribute_termGet a single attribute term
create_attribute_termCreate an attribute term
update_attribute_termUpdate an attribute term
delete_attribute_termDelete an attribute term

Product Categories

Manage the hierarchical product category structure.

ToolDescription
get_product_categoriesGet WooCommerce product categories
get_product_categoryGet a single product category
create_product_categoryCreate a product category
update_product_categoryUpdate a product category
delete_product_categoryDelete a product category

Product Tags

Manage flat product tags for flexible organization.

ToolDescription
get_product_tagsGet WooCommerce product tags
get_product_tagGet a single product tag
create_product_tagCreate a product tag
update_product_tagUpdate a product tag
delete_product_tagDelete a product tag

Product Reviews

Manage customer product reviews and ratings.

ToolDescription
get_product_reviewsGet product reviews
get_product_reviewGet a single product review
create_product_reviewCreate a product review
update_product_reviewUpdate a product review
delete_product_reviewDelete a product review

Product Metadata

Manage custom metadata fields attached to products.

ToolDescription
get_product_metaGet meta data for a WooCommerce product
create_product_metaCreate meta data for a WooCommerce product
update_product_metaUpdate meta data for a WooCommerce product
delete_product_metaDelete meta data from a WooCommerce product

Orders

Core order lifecycle management tools.

ToolDescription
get_ordersGet a list of WooCommerce orders
get_orderGet a single WooCommerce order by ID
create_orderCreate a new WooCommerce order
update_orderUpdate an existing WooCommerce order
delete_orderDelete a WooCommerce order

Order Notes

Manage notes attached to orders — both internal staff notes and customer-facing communications.

ToolDescription
get_order_notesGet notes for a WooCommerce order
get_order_noteGet a single order note
create_order_noteCreate a note on an order
delete_order_noteDelete an order note

Order Refunds

Process and manage refunds for orders.

ToolDescription
get_order_refundsGet refunds for a WooCommerce order
get_order_refundGet a single order refund
create_order_refundCreate a refund for an order
delete_order_refundDelete an order refund

Order Metadata

Manage custom metadata fields attached to orders.

ToolDescription
get_order_metaGet meta data for a WooCommerce order
create_order_metaCreate meta data for a WooCommerce order
update_order_metaUpdate meta data for a WooCommerce order
delete_order_metaDelete meta data from a WooCommerce order

Customers

Customer account management tools.

ToolDescription
get_customersGet a list of WooCommerce customers
get_customerGet a single WooCommerce customer by ID
create_customerCreate a new WooCommerce customer
update_customerUpdate an existing WooCommerce customer
delete_customerDelete a WooCommerce customer

Customer Metadata

Manage custom metadata fields attached to customer accounts.

ToolDescription
get_customer_metaGet meta data for a WooCommerce customer
create_customer_metaCreate meta data for a WooCommerce customer
update_customer_metaUpdate meta data for a WooCommerce customer
delete_customer_metaDelete meta data from a WooCommerce customer

Shipping Zones

Manage shipping zones that define geographic regions for shipping method assignment.

ToolDescription
get_shipping_zonesGet all WooCommerce shipping zones
get_shipping_zoneGet a single shipping zone by ID
create_shipping_zoneCreate a new shipping zone
update_shipping_zoneUpdate an existing shipping zone
delete_shipping_zoneDelete a shipping zone

Shipping Methods

Manage shipping methods assigned to specific shipping zones.

ToolDescription
get_shipping_methodsGet all available shipping methods
get_shipping_zone_methodsGet shipping methods for a specific zone
create_shipping_zone_methodAdd a shipping method to a zone
update_shipping_zone_methodUpdate a shipping method in a zone
delete_shipping_zone_methodDelete a shipping method from a zone

Shipping Zone Locations

Manage geographic locations (countries, states, postcodes) assigned to shipping zones.

ToolDescription
get_shipping_zone_locationsGet locations for a shipping zone
update_shipping_zone_locationsUpdate locations for a shipping zone

Taxes

Manage tax classes and individual tax rates.

ToolDescription
get_tax_classesGet all WooCommerce tax classes
create_tax_classCreate a new tax class
delete_tax_classDelete a tax class
get_tax_ratesGet WooCommerce tax rates
get_tax_rateGet a single tax rate by ID
create_tax_rateCreate a new tax rate
update_tax_rateUpdate an existing tax rate
delete_tax_rateDelete a tax rate

Coupons

Manage discount coupons with various discount types and usage restrictions.

ToolDescription
get_couponsGet a list of WooCommerce coupons
get_couponGet a single coupon by ID
create_couponCreate a new WooCommerce coupon
update_couponUpdate an existing coupon
delete_couponDelete a coupon

Payment Gateways

View and configure payment gateway settings.

ToolDescription
get_payment_gatewaysGet all payment gateways
get_payment_gatewayGet a single payment gateway
update_payment_gatewayUpdate a payment gateway

Reports

Generate various sales, inventory, and customer reports.

ToolDescription
get_sales_reportGet WooCommerce sales report
get_products_reportGet WooCommerce products report
get_orders_reportGet WooCommerce orders report
get_categories_reportGet WooCommerce categories report
get_customers_reportGet WooCommerce customers report
get_stock_reportGet WooCommerce stock report
get_coupons_reportGet WooCommerce coupons report
get_taxes_reportGet WooCommerce taxes report

Settings

Manage WooCommerce store settings organized by settings group.

ToolDescription
get_settingsGet all WooCommerce settings groups
get_setting_optionsGet options for a settings group
update_setting_optionUpdate a specific setting option

System Status

Access diagnostic information and run system maintenance tools.

ToolDescription
get_system_statusGet WooCommerce system status information
get_system_status_toolsGet WooCommerce system status tools
run_system_status_toolRun a WooCommerce system status tool

Data

Access geographic and currency reference data used by WooCommerce.

ToolDescription
get_dataGet WooCommerce data index
get_continentsGet list of continents
get_countriesGet list of countries
get_currenciesGet list of currencies
get_current_currencyGet the current store currency

Public Endpoint Tools

When using the HTTP transport's public endpoint (POST /mcp), only 4 tools are available with sanitized responses:

ToolDescription
get_productsList products (sanitized — no cost, stock, or internal metadata)
get_productGet a single product (sanitized)
get_product_detailsGet detailed product information (sanitized)
search_productsSearch products (sanitized)

These tools are designed for customer-facing applications that need product data without exposing sensitive business information.


Tool Usage Examples

Listing Products

Ask your AI assistant:

"Show me the 10 most recent products in the 'Accessories' category"

The assistant will call get_products with appropriate filters.

Creating an Order

"Create a test order with product ID 42 (quantity 2) for customer [email protected]"

The assistant will call create_order with the line items and customer data.

Checking System Health

"What's the WooCommerce system status? Are there any critical issues?"

The assistant will call get_system_status and interpret the diagnostics.

Generating Reports

"Give me a sales report for last month"

The assistant will call get_sales_report with the appropriate date range parameters.