# Mercado Libre MCP for AI Agents AI Agent Connect

> Mercado Libre MCP. Manage your Mercado Libre store through an AI agent. List new products, track active orders, handle shipments, and respond to buyer questions in one place. It connects your seller account to your favorite AI client so you can handle the heavy lifting of marketplace management without constant tab switching.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_GacTng0FYX0XPEIZEjbdsIQ3X2rBVJ6Oc71z22Sf/ai-agent-connect
- **Tags:** marketplace, selling, customer-support, logistics, retail

## Description

Running a Mercado Libre store usually means jumping between dozens of tabs to check order statuses, update shipping info, and reply to frantic buyers. This Connector changes that by letting your AI agent do the legwork for you. Instead of hunting for a specific order ID or manually figuring out which category a new product belongs to, you just ask your agent. It handles the data fetching and the heavy lifting of interacting with the marketplace API. You can check your shipment SLAs to stay on top of your seller reputation or look into active claims to see what is going wrong with a return. It is a way to keep your business moving without getting bogged down in the dashboard. You can find this and thousands of other connectors in the Vinkius catalog to build out your specific e-commerce stack.

## Tools

### create_item
Publish a new product to your store with all necessary details like price and category.

### get_claim
Pull specific details about a post-purchase claim to start the resolution process.

### get_me
Retrieve your current Mercado Libre user profile information.

### get_order
Fetch full metadata for a specific order, including payment and buyer details.

### get_post_sale_messages
Pull all messages sent after a sale was completed.

### get_promotion_candidate
Identify which of your items are eligible for current promotions.

### get_return_details
Get the specific details regarding a product return.

### get_sale_price
Check the current active sale price for a specific item.

### get_shipment_sla
View the Service Level Agreement deadlines for your shipments.

### get_shipment
Pull the current status and information for a specific shipment.

### get_user_addresses
List the addresses associated with a specific user.

### predict_category
Get the best category prediction for a product based on its title.

### search_orders
Search through your seller orders to find specific transactions.

### search_questions
Look through buyer questions to find specific inquiries.

### send_post_sale_message
Send a direct message to a buyer after a sale has occurred.

### create_test_user
Generate a test user account for development or testing purposes.

### answer_question
Provide a direct answer to a buyer's question on the marketplace.

## Prompt Examples

**Prompt:** 
```
I need to see the status of order #554433.
```

**Response:** 
```
I've found the details for order #554433:

| Field | Detail |
| :--- | :--- |
| **Status** | Paid |
| **Buyer** | Juan P. |
| **Item** | Wireless Headphones |
| **Shipment** | Pending |

Would you like me to check the shipment SLA for this order?
```

**Prompt:** 
```
What's the shipping deadline for my last 5 orders?
```

**Response:** 
```
Here are the deadlines for your 5 most recent orders:

* **Order #1029**: Due by tomorrow at 4:00 PM
* **Order #1030**: Due by tomorrow at 4:00 PM
* **Order #1031**: Due by Friday at 12:00 PM
* **Order #1032**: Due by Friday at 12:00 PM
* **Order #1033**: Due by Monday at 9:00 AM
```

**Prompt:** 
```
Is my new 'Gaming Mouse' eligible for any promos?
```

**Response:** 
```
I checked the promotion candidates for your account. 

**Gaming Mouse** is currently **eligible** for the 'Summer Tech Sale' promotion. You can apply this to your listing to increase visibility.
```

## Capabilities

### List products with full attributes
Publish new items to your store with all the necessary details like price and category.

### Fetch order metadata
Retrieve detailed information for specific orders including payment status and buyer info.

### Monitor shipment SLAs
Track shipment statuses and deadlines to ensure you stay within marketplace requirements.

### Manage buyer communications
Search for and answer buyer questions or send post-sale messages directly.

### Inspect claims and returns
Get the specific details on active claims and product returns to resolve issues faster.

### Check promotion eligibility
Identify which of your items are eligible for current marketplace promotions and sales.

## Use Cases

### Handling a high volume of buyer questions
A support rep asks the agent to search for all recent questions. The agent finds the relevant buyer inquiries and provides direct answers to clear the queue.

### Monitoring shipment deadlines
A logistics coordinator asks for the SLA deadlines on all pending shipments. The agent identifies which items need to go out first to protect the seller status.

### Listing products with correct categories
A manager wants to list a new product but is unsure of the category. The agent predicts the correct category based on the product title.

### Resolving specific order issues
A seller needs to know the payment status of a specific order. The agent pulls the full metadata for that order ID instantly.

## Benefits

- Stop digging through dashboards to find order info. You can pull exactly what you need instantly without navigating menus.
- Keep your seller reputation high by monitoring deadlines to ensure you stay within marketplace requirements.
- Speed up listing new products by getting the best category predictions for your items automatically.
- Handle customer service faster by searching for questions and providing direct answers in one place.
- Stay on top of returns and issues by pulling claim details directly into your chat for faster resolution.
- Identify growth opportunities by checking which of your items are eligible for current promotions.

## How It Works

The bottom line is you get a conversational interface for your entire Mercado Libre seller dashboard.

1. Subscribe to the Mercado Libre MCP on Vinkius.
2. Enter your Mercado Libre Access Token in the configuration.
3. Ask your AI client to find orders, check shipments, or answer buyer questions.

## Frequently Asked Questions

**Can I use the Mercado Libre MCP to list new products?**
Yes, you can use it to publish new items to your store with full attribute support, including price and category details.

**Does the Mercado Libre MCP handle customer messages?**
Yes, it can search for buyer questions and provide answers directly, helping you manage your customer service flow.

**How do I keep my seller reputation high with this?**
You can use the shipment tools to monitor your SLA deadlines in real-time, ensuring you never miss a dispatch window.

**Can it help with returns and claims?**
Yes, it can pull specific details on active claims and product returns so you can resolve customer issues more efficiently.

**Is this for Mercado Libre sellers only?**
Yes, this Connector is designed specifically to connect your Mercado Libre seller account to your AI client for marketplace management.

**Can I check my sale prices using the Mercado Libre MCP?**
Yes, you can quickly check the current active sale price for any specific item in your store through a simple chat command.

**How can I check if a shipment is at risk of affecting my reputation?**
You can use the `get_shipment_sla` tool with the Shipment ID. It will return the maximum dispatch time allowed to avoid penalties on your seller metrics.

**Can the AI help me find the right category for a new product?**
Yes! Use the `predict_category` tool by providing the product title and your site ID (e.g., MLA, MLB). The agent will suggest the most accurate category ID for your listing.

**How do I see pending questions from buyers?**
Ask the agent to run `search_questions` using your Seller User ID. It will list the recent questions asked by buyers on your items so you can answer them using `answer_question`.