# Mercado Livre Orders MCP for AI Agents AI Agent Connect

> Mercado Livre Orders MCP lets you manage your e-commerce sales directly through an AI agent. You can search for orders by status, track shipments, update tracking numbers for non-Mercado Envios deliveries, and handle cancellations or buyer feedback without leaving your chat interface. It connects your Mercado Livre store to your AI workflow.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_OMp7BvyK1pjk98GfpDEuDNnOygJ3weBdJXFEMJix/ai-agent-connect
- **Tags:** order-tracking, shipment-management, sales-processing, invoice-management, cancellation-handling

## Description

You're probably drowning in tabs. You open your marketplace dashboard to check a status, then switch to your email to talk to a customer, then back to the dashboard to copy a tracking number. It's a constant cycle of copy-pasting. This Connector lets you stay in one place. You just tell your agent what you need, and it pulls the data or updates the record for you. See buyer details, check if a payment went through, or see exactly what items are in a pending shipment. It even handles the paperwork side of things, like registering invoices or checking what ratings buyers left on your profile. By bringing these actions into your primary workspace, you stop jumping between apps and start actually moving products. You can get this set up as part of the larger Vinkius catalog, where you connect once to get access to thousands of tools like this one.

## Tools

### get_feedback
Get buyer feedback and reputation for a specific sale. This helps you monitor your store's reputation.

### set_tracking
Set tracking number for a shipment. Use this for shipments handled outside of Mercado Envios.

### cancel_order
Cancel a sale when necessary. You must provide a valid reason for the cancellation.

### get_order
Get details of a specific sale. Use this to see buyer info, items, and totals instantly.

### search_orders
Search for sales and orders. Find specific sales by status like paid or delivered.

### get_shipments
List shipments associated with an order. View all parts of a multi-item delivery.

### get_shipping_info
Get shipping details for an order. Check carrier names and tracking codes quickly.

## Prompt Examples

**Prompt:** 
```
I need to see all my orders that are marked as paid but haven't shipped yet.
```

**Response:** 
```
### Pending Shipments
I've found 3 orders that are paid but ready for shipping:

| Order ID | Total | Item | Status |
| :--- | :--- | :--- | :--- |
| **MLB-102** | R$150.00 | Wireless Headphones | Paid |
| **MLB-105** | R$89.90 | USB-C Hub | Paid |
| **MLB-109** | R$210.00 | Gaming Mouse | Paid |
```

**Prompt:** 
```
Can you get the buyer details and total for order MLB-9982?
```

**Response:** 
```
### Order Details: MLB-9982

*   **Status:** Paid
*   **Buyer:** João Silva
*   **Total:** R$150.00
*   **Item:** Wireless Headphones

Would you like me to check the shipping status for this order as well?
```

**Prompt:** 
```
Update the tracking number for shipment 445 to 'TRK778899' and tell me it's done.
```

**Response:** 
```
✅ **Success!**

I've updated the tracking number for shipment **445** to **TRK778899**. Your shipping records are now up to date.
```

## Capabilities

### Search sales by status
Find orders that are paid, shipped, or delivered in seconds.

### Fetch buyer and item details
Get full information on specific sales including totals and items.

### View shipping status
See carrier info and tracking codes for any order.

### Update tracking numbers
Set tracking for shipments handled outside the standard platform.

### Pull buyer ratings
Check comments and reputation scores left by customers.

### Cancel sales with reasons
Remove orders from your queue when a valid reason is provided.

## Use Cases

### Answering 'Where is my stuff?' pings
A customer asks about a late package. The agent uses get_shipping_info to find the carrier and current location.

### Bulk tracking updates
A logistics lead needs to update 50 tracking codes for a new batch. The agent uses set_tracking to handle the list.

### Handling double orders
A seller needs to cancel a double-ordered item. The agent uses cancel_order after the user provides the reason.

### Reputation monitoring
A seller wants to know why a buyer left a 3-star review. The agent uses get_feedback to show the comment.

## Benefits

- Stop tab switching by using search_orders to find shipments without leaving your agent.
- Provide faster support by pulling buyer details with get_order instantly.
- Keep your logistics accurate by using set_tracking for third-party carriers.
- Monitor your reputation by checking buyer ratings with get_feedback on demand.
- Handle high-volume tasks like invoice registration via your AI agent.
- Reduce errors in order fulfillment by using cancel_order with specific reasons.

## How It Works

The bottom line is you get a conversational interface for your entire Mercado Livre order management system.

1. Subscribe to the Mercado Livre Orders MCP on Vinkius.
2. Provide your Mercado Livre OAuth2 Access Token.
3. Ask your AI agent to find, track, or update your orders.

## Frequently Asked Questions

**Can the Mercado Livre Orders MCP help me manage my store's sales?**
Yes, it lets your AI agent search for orders by status, view buyer info, and handle cancellations. This keeps your sales workflow centralized in your chat app.

**How does this Connector handle tracking for non-Mercado Envios shipments?**
You can use the tool to manually input tracking numbers for any carrier you use. This ensures your customers get accurate updates regardless of the shipping method.

**Can I use this to see what customers are saying about my products?**
Yes, the Connector can pull ratings and comments left by buyers. This helps you monitor your store's reputation and respond to feedback more quickly.

**Is the Mercado Livre Orders MCP good for customer support?**
It's excellent for support. You can quickly pull specific order details and shipping info to answer buyer questions without constantly switching windows.

**Can I cancel orders through the Mercado Livre Orders MCP?**
Yes, you can use the Connector to cancel sales. You just need to provide a valid reason for the action, like a wrong address or an out-of-stock item.

**Does this Connector work with my current AI client?**
It works with any MCP-compatible client, including Claude, Cursor, and Windsurf. You just connect it once and you're ready to go.

**How can I see all my pending orders?**
Use the `search_orders` tool with status set to 'paid' or 'handling'. It will return a list of orders ready to be shipped.

**How do I update the tracking number for a shipment?**
Use the `set_tracking` action with the Order ID, Shipment ID, Carrier ID, and the Tracking Number.

**Can I cancel a sale?**
Yes, use `cancel_order`. Be aware that cancelling orders can negatively impact your seller reputation metrics.

**Can I register an invoice (Nota Fiscal) for a shipment?**
Absolutely. Use the `register_invoice` tool with the shipment ID, invoice number (NF-e key), and access key. This is required for sellers in Brazil to comply with tax regulations.