# Mercado Livre Interactions MCP

> Mercado Livre Interactions gives your AI client full control over managing seller communication and performance data on Mercado Livre. Quickly get answers to unanswered buyer questions, track real-time reputation scores, and view detailed metrics like late shipments or cancellations—all from a single conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** seller-reputation, buyer-communication, customer-service, performance-metrics, q-and-a

## Description

Managing sales across major marketplaces means dealing with constant streams of messages, performance alerts, and customer questions. This MCP centralizes all that data so your agent doesn't just talk about selling; it actually manages the process for you. You can instantly list unanswered buyer queries and draft replies, or pull up a complete message history tied to a specific sale. Need to know if things are going well? Check your current seller reputation level and view performance metrics detailing cancellations or claim rates. Accessing all this data is simple: just connect through Vinkius's catalog and let your AI client handle the rest. It’s about making sure you always respond fast and keep those sales moving.

## Tools

### answer_question
Sends a reply directly back to the buyer regarding their specific question.

### get_messages
Retrieves all communication messages exchanged for a single, specific sale.

### get_metrics
Pulls detailed reports on seller performance metrics like cancellation rates and late shipments.

### get_questions
Lists all current unanswered buyer questions, optionally filtering by a specific item ID.

### get_reputation
Checks your current seller reputation level and related scoring metrics.

## Prompt Examples

**Prompt:** 
```
Show me my unanswered questions.
```

**Response:** 
```
Found 2 unanswered questions: 1. 'Does it come with a charger?'. 2. 'Is it compatible with iPhone 15?'.
```

**Prompt:** 
```
Answer question 999 with 'Yes, it includes the original charger.'
```

**Response:** 
```
Answer sent successfully! The buyer will receive a notification.
```

**Prompt:** 
```
Check my seller reputation and metrics.
```

**Response:** 
```
Reputation Level: Green (MercadoLíder). Metrics: Late shipments 2%, Cancellations 1%, Claims 0.5%.
```

## Capabilities

### Resolve Buyer Questions
The agent sends replies to specific buyers based on their submitted questions.

### Audit Seller Status
Retrieve your current seller reputation status and associated performance metrics.

### Review Order Communications
Pull up the full conversation log for any single, completed sale.

### Analyze Performance Data
Generate detailed reports on operational performance, like shipment delays or claim rates.

### Identify Pending Inquiries
List all unanswered questions submitted by buyers for your products.

## Use Cases

### Addressing a Product Inquiry
A buyer asks, 'Is this compatible with my old model?' Instead of searching through emails, you ask your agent to get_questions. You immediately see the query and use answer_question to send a definitive reply confirming compatibility.

### Post-Sale Support Audit
A customer complains about shipping delay. Your support team asks the agent to get_messages for that sale. They instantly pull up the full communication log, proving when the buyer was first notified of the delay.

### Quarterly Performance Review
The brand manager needs a quick health check. The agent runs get_metrics and get_reputation in sequence, providing an executive summary: 'Late shipments are 2%, but your overall reputation is solid.' 

### Handling Mass Queries
You notice multiple buyers asking about warranty details. You use get_questions to compile all the unique inquiries into a list, allowing you to craft one master response and deploy it using answer_question.

## Benefits

- Stop manually checking dashboards for performance data. Use get_metrics to instantly pull detailed reports on late shipments, cancellations, and claim rates.
- Never miss a buyer query again. The tool lets you use get_questions to list all unanswered questions, so your agent can draft and send replies via answer_question.
- Keep your brand managers in the loop by checking your seller reputation using get_reputation. You always know if you're maintaining that 'Green' status needed for peak sales.
- Need context on a specific order? Use get_messages to pull up the entire communication log, giving your support team instant access to the full history of interactions.
- Cut down response time significantly. Your AI client handles both checking unanswered questions (get_questions) and replying to them (answer_question), making customer service faster than ever.

## How It Works

The bottom line is that your AI client uses these tools to talk directly to Mercado Livre, letting you get real-time operational data without opening any dashboards.

1. Subscribe to this MCP and provide your Mercado Livre OAuth2 Access Token credentials.
2. Direct your AI client to perform an action, like asking it to 'check my late shipment rates' or 'answer the buyer about the charger'.
3. The agent executes the necessary calls and returns structured data—whether it’s a list of unanswered questions or a success message confirming a reply.

## Frequently Asked Questions

**How do I check my unanswered questions using Mercado Livre Interactions?**
You use the get_questions tool. You can run it generally to see all pending queries, or you can pass a specific item ID if you only want to filter by one product.

**Can I reply to buyers using Mercado Livre Interactions?**
Yes, the answer_question tool lets your agent draft and send replies directly back to the buyer. You just tell it what you want to say, and it handles the sending process.

**What metrics does get_metrics provide?**
get_metrics provides detailed operational data. This includes things like late shipments percentage, cancellation rates, and claim statistics, helping you see exactly where your performance is slipping.

**Does Mercado Livre Interactions only show general metrics?**
No, it's much more specific than that. You can use get_messages to pull up the exact communication log for a single sale, giving you granular order details.

**If I check my reputation using Mercado Livre Interactions, what do I get?**
The get_reputation tool gives you your current seller level (like Green or Yellow) and the core metrics that determine that standing. It's a quick health check for your shop.