# Mercado Livre Catalog MCP for AI Agents AI Agent Connect

> Mercado Livre Catalog MCP lets you manage your Latin American e-commerce presence directly through your AI client. You can create new listings, update stock levels, adjust prices, and browse categories without leaving your chat interface. It connects your Mercado Livre store to your agent for hands-free catalog management. This tool is built for sellers who need to keep their storefront accurate and up to date without the manual grind of the seller panel.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_NSTPbAj0XuBuW7edCkhzAJScPCSig1L7M8NPc4P6/ai-agent-connect
- **Tags:** product-listings, stock-control, pricing-strategy, marketplace-management, catalog-management

## Description

This Mercado Livre catalog connector lets you manage a high-volume store without juggling dozens of tabs, constantly refreshing the seller panel to check stock, and manually typing out product specs for every new item. It's a tedious cycle that eats up time you could spend on actual growth. This connection changes that by letting your AI agent do the heavy lifting. Instead of clicking through menus, you just tell your agent to push a new product live or update the price on a specific item. You can ask for the mandatory attributes for a new category or find a specific listing in your catalog instantly. Because Vinkius makes it so easy to connect these tools, you get a unified way to handle your entire Latin American storefront. It turns a multi-step manual process into a simple conversation, letting you keep your inventory accurate and your prices competitive without the usual headache of manual data entry. You can finally spend your time on strategy instead of data entry. This means you can handle a massive catalog with the same effort as a small one, keeping your shop running smoothly while you focus on the big picture.

## Tools

### get_domain_attributes
Pulls the required specs for a specific category so you don't have to guess what's mandatory.

### create_item
Publishes a brand new product listing with all the necessary details and attributes.

### delete_item
Closes or deactivates a listing that you no longer want to sell.

### get_item
Fetches all the specific details for a single listing from your catalog.

### update_price
Changes the selling price of an item to keep your store competitive.

### search_items
Finds specific listings in your own account based on your search terms.

### update_stock
Adjusts the available quantity for an item to keep your inventory accurate.

### update_item
Modifies the title, description, or attributes of an existing listing.

### get_categories
Lists the top-level categories on Mercado Livre Brasil to help you organize your shop.

## Prompt Examples

**Prompt:** 
```
What do I need to include to list a new smartphone?
```

**Response:** 
```
To list a smartphone in the Electronics category, you'll need to provide the following mandatory attributes:

* **Brand**
* **Model**
* **Storage Capacity**
* **Color**
* **Screen Size**
* **RAM**

Would you like me to help you draft the listing details for these?
```

**Prompt:** 
```
Update the price of my wireless mouse to 45.00 BRL.
```

**Response:** 
```
I've updated the price for your wireless mouse. It's now live at **R$45.00**. Is there anything else you'd like to change?
```

**Prompt:** 
```
Are there any items in my catalog that are out of stock?
```

**Response:** 
```
I checked your listings and found 3 items with a quantity of 0:

| Item Name | ID |
| :--- | :--- |
| Wireless Mouse | MLB123 |
| USB Cable | MLB456 |
| Phone Case | MLB789 |

Would you like me to update the stock for any of these?
```

## Capabilities

### Publish new products
Publish a new product listing with all the necessary details and attributes in one go.

### Update inventory quantities
Update the available quantity for an item to keep your inventory counts accurate.

### Change item prices
Change the price of an item instantly to stay competitive in your market.

### Find specific listings
Find specific listings in your account using natural language search terms.

### Get required category attributes
Pull the mandatory specs for any category to ensure your listings meet marketplace requirements.

### Deactivate old listings
Deactivate or close a listing that is no longer available for sale.

## Use Cases

### Handling an out of stock spike
An inventory manager notices a spike in sales and tells the agent to use update_stock to increase the count for the top 10 items so they don't sell out.

### Launching a new product
A seller describes a new wireless mouse and asks the agent to use create_item to put it live in the Accessories category with the correct specs.

### Reacting to competitor pricing
A marketer sees a competitor drop prices and asks the agent to use update_price on all items in a specific category to maintain their market share.

### Seasonal catalog cleanup
A store owner wants to remove old electronics and asks the agent to use delete_item on all listings from last year to clear up their storefront.

## Benefits

- Update stock levels instantly with update_stock to prevent overselling and keep your inventory accurate across all your listings.
- Push new products live faster using create_item to expand your catalog without the manual work of filling out long forms.
- Stay competitive by using update_price to adjust your costs and margins in real time as the market shifts around you.
- Find products quickly with search_items so you don't waste time digging through the seller panel to find a specific ID.
- Ensure listing accuracy by using get_domain_attributes to see exactly what the marketplace requires for each new category.
- Clean up your shop by using delete_item to remove unavailable products from your active catalog and keep your store tidy.

## How It Works

The bottom line is you get a voice-controlled way to manage your Mercado Livre store.

1. Subscribe to the Mercado Livre Catalog MCP on Vinkius.
2. Provide your Mercado Livre OAuth2 Access Token.
3. Start giving commands to your AI client to manage your shop.

## Frequently Asked Questions

**Can I use Mercado Livre Catalog MCP to manage my store's inventory?**
Yes, you can use it to update stock levels instantly. This ensures your store stays accurate and prevents you from overselling items that are no longer in the warehouse.

**How does Mercado Livre Catalog MCP help with new product listings?**
It allows you to create new listings using natural language. You can describe your product to your AI agent, and it will handle the details of putting it live on the marketplace.

**Can I use Mercado Livre Catalog MCP to change prices?**
Yes, you can use it to change prices on specific items or across your catalog. This makes it much faster to adjust your margins as market conditions change.

**Does Mercado Livre Catalog MCP work for all countries?**
This Connector is specifically designed for Mercado Livre Brasil. It handles the specific category requirements and catalog structures for the Brazilian marketplace.

**Can Mercado Livre Catalog MCP find my old listings?**
Yes, you can ask your agent to search your account for specific listings. It can find them by name or other details, making it easy to locate and manage older products.

**Is Mercado Livre Catalog MCP good for large catalogs?**
Yes, it is ideal for high-volume sellers. It allows you to manage a massive number of products with the same effort as a small catalog by using your AI agent to do the heavy lifting.

**How do I get an Access Token for Mercado Livre?**
Go to the [**Mercado Livre Developers**](https://developers.mercadolivre.com.br) portal, create an App, and use the OAuth2 flow to generate your Access Token. It usually starts with `APP_USR-...`.

**Can I create listings with images?**
Yes, the create_item tool accepts a JSON body where you can include picture IDs. Ensure images are already uploaded to Mercado Livre's servers via their Picture API first.

**How do I update stock for multiple items?**
You can use the update_stock action for each item individually. For bulk updates, we recommend using the stock update endpoint directly or creating a loop in your workflow.

**What listing types does Mercado Livre support?**
Mercado Livre supports several listing types: 'gold_special' (premium with fulfillment), 'gold_pro' (classic), and 'gold' (basic). Each type offers different levels of visibility, fees, and buyer reach.