# WooCommerce MCP

> WooCommerce MCP connects your AI agent directly to your entire e-commerce store backend. You stop logging into dashboards and start asking questions. Your agent can list products, audit historical orders, monitor live system status, and check customer purchase histories—all from a single conversation. Manage everything from sales reports to coupon governance without ever touching the WooCommerce admin panel.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** store-management, sales-reporting, product-catalog, order-tracking, inventory-management, open-source-ecommerce

## Description

Running an online shop means juggling dozens of moving parts: inventory levels, pending shipments, marketing promotions, and complex sales data. This MCP turns that entire operational mess into simple commands for your AI client. You tell your agent what you need—like 'What are my top 5 selling products this month?' or 'Check the status of order #90210.' Your agent executes those requests against your live WooCommerce store data and delivers a clean, conversational report back to you. It acts like having an expert operations manager sitting with you, ready to pull up any record instantly. Because Vinkius manages this connection point, all these capabilities are available through one single subscription, letting you focus purely on running the business, not managing the tools.

Whether it’s verifying if a new product category was published correctly or finding out why an order is stuck in 'pending,' your agent handles the data retrieval and reporting. It keeps your entire e-commerce workflow visible and actionable right inside your preferred AI chat window.

## Tools

### get_order
Pulls specific details for a single order using its unique ID.

### get_product
Retrieves all information about one particular product by its identifier.

### get_system_status
Checks the overall operational health and current version of the WooCommerce platform.

### list_coupons
Lists every active coupon code so you can check promotion rules and expiration dates.

### list_customers
Provides a list of all registered customers in the store database.

### list_orders
Generates a summary list of multiple orders, allowing you to see who ordered and when.

### list_categories
Shows all the major product categories used on your website for organization.

### list_products
Lists every single product available in your catalog, useful for inventory checks.

### list_reports
Retrieves a list of all available sales and performance reports from the platform.

### update_order
Changes the status of an order, such as marking it as 'shipped' or 'cancelled'.

## Prompt Examples

**Prompt:** 
```
List my last 5 orders in WooCommerce.
```

**Response:** 
```
I've retrieved your recent orders. You have 5 new transactions, including order #1234 for $45.00 by John Smith. Would you like the full details for any of them?
```

**Prompt:** 
```
Show me all my draft products.
```

**Response:** 
```
I've found 3 products in draft status: 'New Hoodie', 'Limited Poster', and 'Demo Shirt'. I can provide category and pricing info for each if you like.
```

**Prompt:** 
```
What is the system status of my store?
```

**Response:** 
```
Your WooCommerce system status is healthy. Environment: Production, WooCommerce version: 8.5.0, Database status: OK. Is there anything specific you'd like to check?
```

## Capabilities

### Audit Order History
Retrieve detailed information about specific, recent, or historical orders, including customer details and current status.

### Manage Product Catalog
List all available products and categories to verify product availability, check draft items, or confirm pricing structures.

### Analyze Customer Data
Look up customer profiles and view their complete purchase history to understand buying patterns.

### Check System Health
Get real-time status reports on the store's backend, ensuring everything from database connections to core functions is running smoothly.

### Govern Promotions and Sales
List all active coupons and retrieve detailed sales performance metrics by accessing system reports.

## Use Cases

### Investigating a Missing Order
A customer reports they never got an item. Instead of manually checking every record, you ask the agent to find all recent orders and use `get_order` on the relevant IDs to pull up tracking numbers and confirmation details instantly.

### Quarterly Performance Review
You need data for a board meeting. You instruct your agent to list reports using `list_reports`, then use that information to query sales metrics, building a comprehensive performance summary without ever leaving the chat window.

### Verifying New Inventory
The warehouse team just processed 50 new items. You ask the agent to list all products and check specific ones using `get_product` to confirm they are correctly categorized before listing them for sale.

### Handling a Promotion Error
A customer complains that their discount code isn't working. You use the agent to list all coupons and check the rules using `list_coupons` to see exactly why the promotion might be failing.

## Benefits

- Stop clicking through multiple tabs to get a simple answer. You can ask your agent, 'What is the status of order #XYZ?' and immediately get the full details using `get_order`, making customer service faster.
- Don't waste time manually checking if everything is up-to-date. Use `list_system_status` to confirm the store environment is healthy before a major sale starts, giving you peace of mind.
- Need to know what products are ready for sale? Instead of browsing product dashboards, simply use `list_products` and get a clean list of everything currently active in your catalog.
- Marketing campaigns require constant vigilance. You can instantly check all promotions by calling `list_coupons`, ensuring no expired or misconfigured codes affect sales.
- When an order needs manual status changes, you don't need admin access. Your agent handles the workflow using `update_order` and logs it correctly for your team.

## How It Works

The bottom line is you get immediate, conversational access to deep operational data without ever needing to navigate a complex dashboard.

1. Subscribe to this MCP on Vinkius, then provide your store's URL along with the necessary Consumer Key and Secret credentials.
2. Connect your preferred AI client (like Claude or Cursor) to the MCP. Your agent now has secure access to the e-commerce backend tools.
3. Ask your agent a direct question—for example, 'Show me all orders placed yesterday.' The agent executes the query and presents the results in plain text.

## Frequently Asked Questions

**Can WooCommerce MCP only list products?**
No, it does much more than just listing products. It lets you audit orders using `list_orders`, check customer history via `list_customers`, and even update an order's status with `update_order`.

**How do I get system health info with WooCommerce MCP?**
You use the `get_system_status` tool. This function checks the overall operational integrity of your store, telling you if the database connection or platform version is running correctly.

**What is the difference between list_orders and get_order?**
The `list_orders` tool gives you a summarized overview—a quick list of many transactions. You use `get_order` when you need the deep, detailed metadata for one specific order ID.

**Does WooCommerce MCP handle inventory tracking?**
Yes. By using `list_products` and `get_product`, your agent can give you real-time visibility into product availability and catalog status.

**Can I change an order's status with this MCP?**
Absolutely. The `update_order` tool lets your agent modify the current status of any specific order, allowing you to move it from 'Processing' to 'Shipped,' for example.