# WooCommerce MCP MCP > WooCommerce manages your entire open-source store—products, orders, and customer data—right through your AI agent. This MCP lets you list product catalogs, check order statuses, track sales reports, and audit coupons without logging into WordPress. It’s the command line for running your eCommerce business. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** open-source, inventory-management, online-retail, store-analytics, product-management, wordpress-plugin ## Description Need to manage a complex online store? This MCP connects your WooCommerce setup directly to your AI agent. You can ask it to pull detailed customer profiles or list every active discount coupon for an upcoming sale. Want to know how many orders are stuck in 'processing'? Your agent handles the lookup, status filtering, and data retrieval instantly. It even updates order statuses if a shipment ships early. The real power is that every single action your agent takes—whether it's pulling customer history or running a sales report for last quarter—is logged to an immutable audit trail by Vinkius. This means you always know exactly what happened, who triggered the change, and how much budget was spent. You treat the whole platform like one cohesive system. ## Tools ### get_customer_details Pulls detailed information for one specific registered store customer. ### get_order_details Retrieves the full billing and item breakdown for a single store order. ### get_product_details Pulls specific data points about any individual product, like price or category. ### get_sales_report Generates a summary of revenue and performance for a given time period (week, month, year). ### list_store_categories Lists all product categories defined in your store. ### list_store_coupons Retrieves a list of every active discount coupon available right now. ### list_store_customers Lists your store's registered customers using pagination to handle large databases. ### list_store_orders Lists all orders, allowing you to filter by status like 'processing' or 'completed'. ### list_store_products Generates a paginated list of every product available in your catalog. ### update_order_status Changes the status of an order, moving it through defined stages like 'processing' or 'completed'. ## Prompt Examples **Prompt:** ``` List all processing orders in my WooCommerce store. ``` **Response:** ``` I found 4 orders currently in 'processing' status: #501 (Total: $120.00), #502 (Total: $45.50), #503 (Total: $89.00), and #504 (Total: $210.00). Would you like to see the shipping address for any of these? ``` **Prompt:** ``` What is the current stock level for product ID '123'? ``` **Response:** ``` Product 'Classic T-Shirt' (ID: 123) currently has 15 units in stock. It is assigned to the 'Apparel' category. Would you like me to check other items in this category? ``` **Prompt:** ``` Give me a sales summary for this week. ``` **Response:** ``` Sales report for this week: You have generated $2,450.00 in total revenue across 32 orders. Your top-selling item was the 'Leather Wallet'. No refunds were processed during this period. ``` ## Capabilities ### Check Product Details Get specific information on any product in your catalog, including its price and inventory count. ### Audit Sales Performance Generate summary sales reports for defined time periods like a week or a full year. ### List All Customers Retrieve paginated lists of registered users and access their deep profile data, including total spending. ### Monitor Orders See a filtered list of orders based on status (e.g., 'pending' or 'completed'). ### Update Order Statuses Change the life cycle status of an existing order, moving it from pending to shipped. ## Use Cases ### The Fulfillment Bottleneck An ops manager needs to mark 20 orders as 'shipped' because they left early. Instead of opening the dashboard and clicking status changes twenty times, they tell their agent: 'Update order statuses for all items in this batch to completed.' The MCP handles the bulk updates via `update_order_status`. ### The Promotion Question A marketing team member asks if a specific coupon is still running. They use `list_store_coupons`, instantly verifying its status and rules without manually checking the promotions tab. ### Customer Support Crisis Support needs to know why a customer, John Doe, hasn't paid for an order since last month. They ask their agent, which uses `get_customer_details` and `get_order_details`, providing immediate billing history. ### The Quarterly Review An owner needs a quick summary of Q2 sales to present to the board. They ask for a yearly report, using `get_sales_report` and getting precise revenue figures immediately. ## Benefits - Update order statuses instantly. Instead of finding the right admin page, just ask your agent to move an item from 'pending' to 'shipped'. - Audit coupons easily. Use `list_store_coupons` to check if a promotion is still active or how many times it’s been used. - Deep customer insights. Need to know a user's total spend? The agent can pull that history using `get_customer_details` instantly. - Know your revenue at a glance. Run the `get_sales_report` tool and get summary data for any time frame—week, month, or year. - Handle massive catalogs. You don't have to scroll through thousands of products; the agent can list them all using `list_store_products`. ## How It Works The bottom line is you get to run complex store operations using simple conversation prompts. 1. You subscribe to this MCP and input your WooCommerce Site URL, Consumer Key, and Secret. 2. Your AI agent connects using the credentials through Vinkius's zero-trust proxy for secure, in-transit access. Your keys never sit on disk. 3. You simply chat with your agent: 'List all completed orders from last month.' The MCP handles everything else. ## Frequently Asked Questions **How do I check if a coupon code works with the list_store_coupons tool?** The `list_store_coupons` tool shows all active coupons. If you need to know which specific items that coupon applies to, use `get_product_details` and reference its metadata. **Can I bulk update order statuses using the update_order_status tool?** The MCP allows status updates for existing orders. While you might need to list them first using `list_store_orders`, the agent handles applying those changes to move items through your pipeline. **What is better, listing products or getting product details?** `list_store_products` gives a broad overview of everything available. Use it when you need a quick inventory count or list. `get_product_details` is for deep dives on one specific item's characteristics. **Does the get_sales_report tool cover tax data?** The report provides summary revenue figures and transaction counts for specified periods, giving you a clear view of overall sales performance. For granular tax breakdown, check your specific accounting software. **If I only have a partial identifier, can the get_customer_details tool still retrieve customer information?** Yes, it handles partially matching identifiers. You don't need the full email or username; providing key pieces of data allows your agent to search and pinpoint the correct profile within WooCommerce. **How do I handle large amounts of records when using list_store_customers?** The tool supports pagination, meaning you won't hit a record limit. Your AI client automatically handles fetching subsequent pages of results until all listed store customers are retrieved. **What specific transaction or billing data can I pull using the get_order_details tool?** The tool provides full billing details, including payment methods used and a breakdown of line items. This lets you verify exactly how an order was paid for and what taxes applied. **When using get_product_details, can I access technical product properties beyond the standard name and SKU?** Absolutely. Beyond basic data, this tool accesses deep metadata like technical specifications and assigned categories. This is useful for building advanced reports on your store's full taxonomy.