# WooCommerce Status Reader MCP

> The WooCommerce Order Status Reader MCP lets your AI agent instantly pull real-time order details directly from your store's backend. Use an existing order ID or a customer email address to check status, shipping method, and tracking numbers automatically. It’s perfect for automating all 'Where is my order?' (WISMO) support queries without logging into any dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** order-tracking, wismo, customer-service, data-retrieval, read-only

## Description

Customer service agents spend huge chunks of time handling the same question: "Where is my order?" This MCP solves that by giving your AI agent read-only access to your WooCommerce store. You can connect this through Vinkius, and your agent instantly gets a verified feed of current order information.

It's designed strictly for reading data. Your agent pulls the status—whether it’s processing, shipped, or completed—and automatically extracts key shipping details like tracking numbers and carrier names. It doesn't modify anything; it just tells you what happened. When a customer asks about Order #10452, your AI client finds that order by ID or email and gives the exact status and link immediately, letting the agent respond without ever opening a browser tab or searching through an admin panel. This capability means faster answers for customers and less headache for your team.

## Tools

### read_woocommerce_order
Reads the real-time status of a WooCommerce order using either an Order ID or customer email.

## Prompt Examples

**Prompt:** 
```
A customer is asking for the status of order #10452. Can you check it for them?
```

**Response:** 
```
I've checked the status of Order #10452. It is currently **COMPLETED** and was shipped via FedEx. The tracking number is 1Z9999999999999999.
```

## Capabilities

### Check real-time order status
The MCP retrieves the current fulfillment stage of any WooCommerce order.

### Find orders by customer email
You can search for recent orders using only a customer's registered email address.

### Extract tracking information
It automatically parses and delivers the shipping carrier, tracking number, and link associated with an order.

## Use Cases

### Customer asks about a delayed shipment
A user types, 'My order #10452 is late.' The agent uses the `read_woocommerce_order` tool to confirm the actual status. Instead of guessing, the AI replies: 'It shipped via FedEx and tracking number 1Z... confirms it's out for delivery today.'

### New customer needs a quick check
A new visitor emails support asking about their recent purchase. The agent uses the customer’s email address to run `read_woocommerce_order`, confirming the order details and providing shipping status immediately.

### Support team handles peak holiday traffic
During a major sale, support agents use this MCP to check dozens of orders quickly. Instead of copying data between tabs, they pass the ID or email into their agent, which instantly returns structured status updates.

### Debugging order fulfillment issues
An ops manager uses the tool's read-only capabilities to check if an order is stuck in 'Pending Payment' when it shouldn't be. This pinpoints whether the issue is system failure or a payment hold.

## Benefits

- Stop asking customers for IDs. Your agent can find an order just from their email, drastically improving the initial support experience.
- Get verified tracking numbers automatically pulled out of WooCommerce's metadata, so your AI client can provide working links immediately.
- Keep it read-only and safe. This MCP only gives access to viewing status; nothing can be modified, refunded, or canceled by the agent.
- Handle high volumes of 'Where is my order?' queries without overloading human agents with repetitive lookups.
- The ability to check orders by ID or email means your agent has maximum flexibility for any customer query.

## How It Works

The bottom line is that you get immediate, accurate order data fed right into your conversation flow, without needing manual lookups.

1. Tell your AI agent to check an order using either a specific WooCommerce Order ID or the customer's email address.
2. The MCP uses this information to communicate with your store and pull the current data feed.
3. Your agent receives a structured response detailing the status, shipment method, and any available tracking links.

## Frequently Asked Questions

**Can I use WooCommerce Order Status Reader MCP with my custom email field?**
The tool requires either the specific Order ID or the customer's registered email address. It cannot search using arbitrary text fields outside of those two parameters.

**Is reading order status safe for my data?**
Yes, this MCP is strictly read-only. Your agent can view statuses and tracking details but cannot issue refunds or modify any part of the order record.

**How do I check an order without knowing the ID?**
Use your AI client to invoke `read_woocommerce_order` by providing only the customer's email address. The tool will search for their most recent orders instead.

**Does WooCommerce Order Status Reader MCP work with all WooCommerce setups?**
It connects via standard WooCommerce APIs, making it reliable for most standard installations. Always check your specific setup documentation if you use custom plugins that alter core order meta data.