# VTEX Orders MCP for AI Agents AI Agent Connect

> VTEX Orders MCP connects your store's order management system to any AI agent. It lets you search, track, invoice, and cancel orders through natural conversation. Manage your entire order lifecycle without leaving your chat interface.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/ai-agent-connect
- **Tags:** order-lifecycle, order-tracking, fulfillment, order-invoicing, logistics-management, customer-orders

## Description

VTEX Orders connects your store's order management system directly to your AI agent so you can handle the entire fulfillment lifecycle through a chat interface. Instead of navigating complex dashboards and clicking through multiple tabs to find a single shipment, you can just ask for the details. You can pull up order history, check payment methods, or find every package currently waiting for handling. It handles the repetitive stuff like moving orders through the pipeline, registering tax invoices, and updating statuses as they progress. If a customer needs to back out of a purchase, you can cancel the order and trigger a refund immediately from the conversation. This gives your team a way to stay on top of logistics without the friction of manual data entry. By including this in your Vinkius catalog, you're giving your operations and support teams a way to get work done faster by talking to their data rather than digging through it.

## Tools

### register_invoice
Attach a tax invoice and tracking number to an order. This automatically moves the order to an Invoiced status.

### search_orders
Search for orders based on their current status. It includes pagination to handle large volumes of data easily.

### update_order_status
Change the status of an order to move it through the fulfillment pipeline. Use this to push orders to the next stage.

### get_tracking_info
Get the carrier, tracking number, and URL for a shipped package. This lets you share real-time info with customers quickly.

### cancel_order
Cancel a specific order and log the reason. This triggers the automatic refund process for the customer.

### get_order
Retrieve the full details of an order using its ID. You will see everything from the items to the payment method.

## Prompt Examples

**Prompt:** 
```
What's the status of order v-9988?
```

**Response:** 
```
Order **v-9988** is currently **Ready for Handling**.

*   **Customer:** Maria Silva
*   **Items:** 2x 'Nike Air Max 90'
*   **Total:** R$ 1,212.30
*   **Payment:** Credit Card (Visa ending 4321)

Would you like me to move this to 'handling' status for you?
```

**Prompt:** 
```
List all orders that are ready for handling.
```

**Response:** 
```
I found **23 orders** with the status 'ready-for-handling'. Here are the first 5:

| Order ID | Customer | Total |
| :--- | :--- | :--- |
| **v-111** | Maria Silva | R$ 299.90 |
| **v-222** | João Souza | R$ 1,450.00 |
| **v-333** | Ana Lima | R$ 89.90 |
| **v-444** | Pedro Santos | R$ 2,100.00 |
| **v-555** | Carla Fernandes | R$ 450.00 |

Would you like to move any of these to 'handling' status?
```

**Prompt:** 
```
Cancel order v-123 because the customer changed their mind.
```

**Response:** 
```
Order **v-123** has been successfully canceled. 

*   **Reason Logged:** Customer changed their mind.
*   **Refund Status:** Automatically initiated via the original payment method.
*   **Expected Delivery:** The customer will receive the refund within 5-10 business days.
```

## Capabilities

### Pull order details
Get the full history of a specific order including items, customer info, and payment methods.

### Filter order lists
Search for orders by status and use pagination to browse large sets of results.

### Advance fulfillment stages
Move orders through the pipeline by updating statuses like moving to handling or invoiced.

### Retrieve shipping tracking
Get the carrier name, tracking number, and direct shipping URL for any shipped package.

### Register tax invoices
Attach tax invoices and tracking numbers to orders to trigger automatic status updates.

### Cancel orders and refunds
Cancel an order with a reason and automatically initiate the refund process.

## Use Cases

### Instant refund for a wrong size
A customer wants to cancel an order because they chose the wrong size. The support agent uses cancel_order to stop it and log the reason immediately.

### Batch moving orders to handling
A fulfillment lead sees 20 orders ready for packing. They ask the agent to use update_order_status to move all of them to handling at once.

### Finding stuck orders
An ops manager needs to find all orders that haven't moved in 24 hours. They use search_orders to filter for specific statuses and identify bottlenecks.

### Quick tracking lookup
A customer asks for a shipping update. The agent uses get_tracking_info to grab the carrier and URL, then pastes it into the chat.

## Benefits

- Faster fulfillment by using update_order_status to move batches of orders through the pipeline instantly.
- Better customer service by using get_tracking_info to provide real-time shipping updates without leaving your chat.
- Reduced manual entry by using register_invoice to automatically update order statuses when tax documents are ready.
- Lower refund friction by using cancel_order to stop orders and initiate refunds in one step.
- Easier audits by using search_orders to filter for specific statuses like ready-for-handling across your entire store.
- Complete visibility by using get_order to see the full history of items, payments, and logistics in one view.

## How It Works

The bottom line is you get a direct line to your VTEX order data without leaving your chat interface.

1. Subscribe to the VTEX Orders MCP in your preferred AI client.
2. Provide your VTEX Account Name, App Key, and App Token from your Admin settings.
3. Ask your agent to find, update, or cancel orders in plain English.

## Frequently Asked Questions

**Can the VTEX Orders MCP handle order cancellations?**
Yes, it can cancel orders directly. When you do this, it also logs the reason and automatically triggers the refund process for your customer.

**How do I use VTEX Orders MCP to update shipping info?**
You can use the Connector to pull tracking numbers and carrier URLs instantly. Your agent can then provide these details to your customers without you having to look them up manually.

**Does VTEX Orders MCP support large order volumes?**
Yes, it includes built-in pagination. This allows your agent to search through and manage large lists of orders without hitting limits or missing data.

**Can I use VTEX Orders MCP to register tax invoices?**
Yes, you can register tax invoices and tracking numbers through the Connector. This will automatically move the order to 'Invoiced' status in your store.

**Is VTEX Orders MCP good for customer support?**
It's a great tool for support teams. It lets agents quickly check order details and tracking info during live conversations, leading to faster resolutions.

**How do I connect VTEX Orders MCP to my AI client?**
Just subscribe to the Connector and enter your VTEX Account Name, App Key, and App Token from your Admin settings. Once connected, your agent can start managing orders.

**How do I get my VTEX API credentials?**
Log in to your VTEX Admin, go to **Account Settings → Application Keys**, and create a new App Key. You'll receive an App Key and App Token pair. You also need your Account Name (the subdomain you use to access the VTEX Admin, e.g., 'mystore'). Ensure the key has **OMS** read/write permissions. No code, no SDK — just connect and go.

**Can my agent register an invoice and tracking number at the same time?**
Yes! The 'register_invoice' tool accepts the invoice number and an optional tracking number in one call. Once submitted, the order automatically moves to 'Invoiced' status — eliminating the manual step of navigating to the VTEX Admin, opening the order detail, and filling each field separately.

**How does the agent handle order cancellations with refunds?**
Just tell your agent to cancel the order. It uses the 'cancel_order' tool with an optional reason (so your team has an audit trail). VTEX then handles the refund automatically based on the payment method. No tab-switching, no admin navigation — your support team resolves it in one conversation.

**Can I monitor fulfillment status across hundreds of orders?**
Absolutely. The 'search_orders' tool supports status filters and pagination, so your agent can scan the entire order queue — for example, listing all orders stuck in 'ready-for-handling' to identify fulfillment delays. Perfect for operations teams managing high-volume VTEX stores with multiple sellers.