# WooCommerce MCP > WooCommerce MCP connects your AI agent directly to your entire open-source e-commerce store. List products, check stock levels, manage complex order statuses, audit coupons, and pull sales reports—all through natural conversation. It’s like having a full-time operations manager for your online shop, available 24/7. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** open-source, inventory-management, online-retail, store-analytics, product-management, wordpress-plugin ## Description Managing an online store means jumping between inventory sheets, order dashboards, and analytics pages. This MCP lets you skip all that clicking. You connect your agent to the system and treat your whole WooCommerce setup like one single source of truth. Need to know if a customer spent enough to qualify for loyalty points? Ask. Want to see how many 'processing' orders are stuck in fulfillment? Ask. You can browse the entire product catalog, checking prices and stock levels instantly. You can also get deep insights into sales performance by pulling summary reports for any period—week, month, or year. The whole process of managing everything from customer profiles to inventory updates happens through simple chat commands, making your agent a true operations assistant that works with whatever AI client you prefer on the Vinkius catalog. ## Tools ### list_store_products Lists all products in the store, supporting pagination for large catalogs. ### update_order_status Changes an existing order's status to options like 'processing', 'completed', or 'refunded'. ### get_customer_details Fetches detailed information for a specific registered store customer. ### get_order_details Retrieves all specific data points associated with one particular store order. ### get_product_details Gets comprehensive information for a single WooCommerce product, including metadata. ### get_sales_report Generates summary sales reports for predefined time frames: week, month, last month, or year. ### list_store_categories Provides a full list of product categories used within the store. ### list_store_coupons Shows all currently active discount coupons and their details. ### list_store_customers Lists registered customers, supporting pagination for bulk viewing. ### list_store_orders Retrieves a paginated list of store orders, filtered by status (e.g., 'pending' 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 and stock details Retrieve detailed information about any specific item in your store’s inventory. ### Track customer profiles Pull comprehensive data on registered customers, including their total spending history and profile details. ### Monitor and update orders List all store orders, filter them by status (like 'processing' or 'completed'), and change an order’s current status instantly. ### Review sales performance metrics Generate summary reports showing total revenue for custom time periods like the last week or year. ### Audit store promotions List and review all active discount coupons to monitor how they are being used by customers. ## Use Cases ### Urgent fulfillment check A warehouse manager needs to know which orders are ready to ship. Instead of opening the order list, they ask their agent to use list_store_orders and filter for 'processing' status. The agent returns a clean list of affected Order IDs, allowing them to send out tracking updates immediately. ### Monthly performance review A store owner needs to report revenue figures for the last quarter. They ask their agent for 'sales summary reports' and specify the period (last_month/year). The agent uses get_sales_report, providing total revenue numbers instantly for the meeting. ### Customer support lookup A customer calls asking about a refund. Instead of manually looking up the order ID, the agent asks for 'order details' using get_order_details and the customer’s name. The agent confirms the purchase date, total cost, and current status in one chat reply. ### Inventory audit The marketing team is planning a flash sale. They need to know which product categories are best sellers and if there are any active discounts that clash with the promo. They use list_store_categories for structure, followed by listing coupons using list_store_coupons. ## Benefits - Stop manual logging into the dashboard. You can use simple chat commands to check sales metrics or update order statuses directly through your agent. - Get a 360-degree view of customer history. Use get_customer_details and list_store_customers to pull deep profile data, including total spending, without needing manual searches. - Streamline fulfillment control. Instead of clicking through the dashboard, you can update order statuses using update_order_status with a single prompt when items ship or are cancelled. - Improve marketing efficiency. List and browse active discount coupons using list_store_coupons to quickly audit promotional campaign usage. - Deep dive into product data. Use list_store_products alongside get_product_details to understand inventory levels, SKUs, and technical category structure for merchandising decisions. ## How It Works The bottom line is you don't log into WooCommerce; you just talk to it. 1. Subscribe to this MCP and provide your WooCommerce Site URL, Consumer Key, and Consumer Secret. 2. Connect your AI agent via any compatible client (Claude, Cursor, etc.). 3. Use natural conversation to request data or perform actions, like asking for 'all processing orders'. ## Frequently Asked Questions **How do I use list_store_orders with WooCommerce?** You tell your agent to list orders and specify what you want to see. You can ask for 'all cancelled orders' or 'processing orders' to filter the results automatically. **Can I check stock levels using get_product_details in WooCommerce?** Yes, this MCP allows you to retrieve deep product details that include current stock counts. Just ask for a specific Product ID and the relevant data point. **Does list_store_products show me everything about my inventory?** It lists your products with pagination, which means it can handle thousands of items without timing out. You get basic info like prices, SKUs, and stock levels right away. **Is update_order_status safe to use for changing order statuses?** Yes, it’s designed to move orders through the full pipeline (pending, processing, completed). Always confirm with your agent that you are updating the correct ID before finalizing the status change. **What is the best way to check sales performance with WooCommerce MCP?** The most direct method is using get_sales_report. Just specify a period—like 'this week' or 'last year'—and the agent pulls the summary for you.