Resumen
El mayor marketplace de Latinoamérica: consulta artículos, productos de catálogo y las publicaciones que compiten en ellos, pedidos, costos de envío, comisiones, visitas, tendencias y preguntas de compradores, gestiona las publicaciones propias del vendedor (crear, validar, cambiar precio, stock y descripción, pausar o finalizar) y sus promociones, y consulta campañas y métricas de Product Ads en Brasil (MLB), Argentina (MLA), México (MLM), Chile (MLC), Colombia (MCO), Perú (MPE) y Uruguay (MLU). Inicia sesión con la cuenta de Mercado Libre del vendedor.
Configuración guiada
Conecta Mercado Libre a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Mercado Libre con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Mercado Libre
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Mercado Libre, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Mercado Libre
El mayor marketplace de Latinoamérica: consulta artículos, productos de catálogo y las publicaciones que compiten en ellos, pedidos, costos de envío, comisiones, visitas, tendencias y preguntas de compradores, gestiona las publicaciones propias del vendedor (crear, validar, cambiar precio, stock y descripción, pausar o finalizar) y sus promociones, y consulta campañas y métricas de Product Ads en Brasil (MLB), Argentina (MLA), México (MLM), Chile (MLC), Colombia (MCO), Perú (MPE) y Uruguay (MLU). Inicia sesión con la cuenta de Mercado Libre del vendedor.
Configuración
- Abre el centro de desarrolladores de tu país en
https://developers.mercadolibre.com/devcentery crea una aplicación. - Registra la URI de redirección
https://cloud.anythingmcp.com/api/mcp-oauth/callbackexactamente como está escrita. Si alojas AnythingMCP por tu cuenta, es<your AnythingMCP URL>/api/mcp-oauth/callback. - Copia el App ID en
MERCADO_LIBRE_CLIENT_IDy la Secret Key enMERCADO_LIBRE_CLIENT_SECRET. - Configura
MERCADO_LIBRE_SITE_DOMAINcon el sitio de tu país:mercadolivre.com.br,mercadolibre.com.ar,mercadolibre.com.mx,mercadolibre.cl,mercadolibre.com.co,mercadolibre.com.peomercadolibre.com.uy. De este valor depende qué página de inicio de sesión se abre. - Instala el conector, haz clic en Authorize with Provider e inicia sesión con la cuenta del vendedor. Mantén los scopes
offline_access read write: las herramientas de publicaciones necesitan write.
Sitios e ids: MLB es Brasil, MLA Argentina, MLM México, MLC Chile, MCO Colombia, MPE Perú y MLU Uruguay. Los ids de artículos y categorías llevan el prefijo del sitio, como MLB1234567890. Las herramientas de vendedor solo responden para el vendedor que inició sesión; mercado_libre_get_user con me devuelve tu id de vendedor.
Crear una publicación: Mercado Libre no tiene sandbox, así que una publicación nueva sale en vivo y puede vender de inmediato. La IA sigue este flujo:
- Predice la categoría a partir del título del producto.
- Lee los atributos de la categoría (envía todos los obligatorios, a menudo marca, modelo y GTIN), sus condiciones de garantía, los tipos de publicación (gold_special es la clásica, gold_pro la premium) y sus límites, como la longitud máxima del título, la cantidad de fotos y el precio mínimo.
- Valida la publicación completa sin publicarla.
- Crea la publicación y luego agrega su descripción en texto plano.
family_name o title: los vendedores en el modelo User Products, que desde 2025 abarca a la mayoría de los vendedores, envían un family_name, un nombre genérico del producto como "Apple iPhone 15 128GB", y ningún title: Mercado Libre escribe el título por su cuenta. Los vendedores que siguen en el modelo anterior envían title. El error "The fields [title] are invalid" significa que necesitas family_name. Una publicación con family_name no acepta cambios de título.
Modificar publicaciones: puedes cambiar precio, stock, fotos, atributos y condiciones de venta; las fotos y los atributos reemplazan la lista completa. Con stock 0 la publicación se pausa hasta que vuelva a haber stock. Las publicaciones se pueden pausar y reactivar, y su descripción se puede reemplazar. El título, la condición y el modo de compra quedan bloqueados en cuanto una publicación tiene ventas.
Primero confirmar: cada escritura actúa sobre tu tienda real, así que la IA te pide confirmación para cada una. Tres herramientas están desactivadas al instalar: mercado_libre_close_listing, que finaliza una publicación de forma definitiva (pausar es la alternativa reversible), mercado_libre_post_answer y mercado_libre_remove_item_from_promotion.
Pedidos, comisiones, preguntas, promociones y Product Ads: la IA también consulta pedidos individuales y el costo de su envío, calcula la comisión de venta para un precio y cuánto te costaría ofrecer envío gratis, y lee hasta 20 publicaciones a la vez. Muestra las visitas de tus publicaciones, las palabras más buscadas de una categoría y, en publicaciones de catálogo, los otros vendedores de la misma página de producto y el precio con el que la ganarías. Lista las preguntas de compradores sin responder, consulta tus invitaciones y campañas de promociones, agrega una publicación a una promoción y lee tus campañas, anuncios y métricas de Product Ads (hasta 90 días atrás; Product Ads debe estar activado en Mercado Ads). mercado_libre_post_answer está desactivado porque una respuesta es pública en la publicación al instante y no se puede editar, y mercado_libre_remove_item_from_promotion porque la publicación vuelve a su precio normal. Actívalas a conciencia en la página del conector; la IA pregunta antes de cada cambio.
¿Ya lo instalaste? Las herramientas nuevas llegan a un conector instalado antes mediante su actualización de catálogo: abre el conector en AnythingMCP y, en Catalog update available, revisa la lista de herramientas nuevas y haz clic en Apply update. Tus credenciales y las herramientas que agregaste tú se mantienen como están, y las herramientas de cierre, respuesta y retiro de promociones llegan desactivadas, igual que en una instalación nueva.
Límites de solicitudes: Mercado Libre responde 429 cuando una aplicación envía demasiadas solicitudes, así que los lotes grandes de cambios en publicaciones se ejecutan uno tras otro, no en paralelo.
Requisitos previos: MERCADO_LIBRE_CLIENT_ID, MERCADO_LIBRE_CLIENT_SECRET, MERCADO_LIBRE_SITE_DOMAIN
Instalar el conector localmente
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Abre http://localhost:3000/connectors/store, elige Mercado Libre e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| Tool | What it does |
|---|---|
mercado_libre_get_item | Fetch full details for a Mercado Libre item by id |
mercado_libre_get_user | Get a user's public profile (typically used to inspect a seller) |
mercado_libre_list_orders | List orders for an authenticated seller |
mercado_libre_predict_category | Suggest the category for a new listing from its title (the category predictor) |
mercado_libre_get_category | Read a category and the rules a listing in it must follow: path_from_root, listing_allowed, status, and settings such as max_title_length… |
mercado_libre_get_category_attributes | List the attributes (technical specifications) of a category: id, name, value_type, allowed values with their value_id, and tags |
mercado_libre_get_category_sale_terms | List the sale terms of a category, such as WARRANTY_TYPE and WARRANTY_TIME with their allowed values and units, to fill sale_terms when… |
mercado_libre_list_listing_types | List the listing types of a site (e.g. gold_pro, gold_special, free) with their names |
mercado_libre_list_seller_items | List the ids of a seller's listings, 50 per page by default (max 100), optionally filtered by status or SKU |
mercado_libre_validate_listing | Check a new listing without publishing it |
mercado_libre_create_listing | Publish a new listing on the seller's account; it goes live and can sell at once |
mercado_libre_update_listing | Change a listing: price, stock (available_quantity), pictures, attributes, sale terms, video or shipping |
mercado_libre_set_listing_status | Pause a listing (hidden from buyers, can be reactivated) or reactivate a paused one |
mercado_libre_close_listing | End a listing for good (status closed) |
mercado_libre_get_listing_description | Read the description text of a listing (plain_text), with its creation and update dates |
mercado_libre_add_listing_description | Add the description to a listing that has none yet, typically right after mercado_libre_create_listing |
mercado_libre_update_listing_description | Replace the description of a listing |
mercado_libre_get_items | Read up to 20 listings in one call (items multiget) |
mercado_libre_get_order | Get one order by id: status, date, buyer nickname, order_items (listing, variation, quantity, unit price), payments, total_amount, shipping… |
mercado_libre_get_shipment_costs | Get the cost breakdown of a shipment: what the buyer paid (receiver) and what the seller pays (senders), with discounts and the gross amount |
mercado_libre_get_free_shipping_cost | Quote what the seller pays to offer free shipping (Mercado Envios) for a listing or for a package size: returns the coverage cost the… |
mercado_libre_get_listing_prices | Work out the selling fees for a price on a site: per listing type, the sale_fee_amount Mercado Libre keeps on each sale (with… |
mercado_libre_get_item_visits | Get the total visits of one or more listings between two dates |
mercado_libre_get_item_visits_by_day | Get the daily visits of one listing over the last N days (time window up to 150 days) |
mercado_libre_get_product | Get a catalog product by id: name, family, attributes, pictures, main features, the domain and buy_box_winner (the listing currently… |
mercado_libre_list_product_items | List the listings that compete on a catalog product page: item_id, seller_id, price, currency, condition, listing type, shipping (free… |
mercado_libre_get_item_price_to_win | Check how a catalog listing competes for the product page: status (winning, sharing_first_place, competing, listed), price_to_win (the… |
mercado_libre_get_category_trends | Get the most searched keywords of a category on a site, by recent growth and volume |
mercado_libre_search_questions | Search buyers' questions on the seller's listings: by seller (all listings) or by one listing, optionally only UNANSWERED ones |
mercado_libre_post_answer | Publish the seller's answer to a buyer's question on a listing |
mercado_libre_list_seller_promotions | List the promotions the seller is invited to or runs (seller-promotions API): id, type (DEAL, MARKETPLACE_CAMPAIGN, PRICE_DISCOUNT… |
mercado_libre_get_promotion | Get the details of one promotion: name, type, status, dates, deadline to join, benefits and, for seller campaigns, the discount rules |
mercado_libre_list_promotion_items | List the seller's listings in a promotion with their status there (candidate = invited, pending, started, finished), price and… |
mercado_libre_get_item_promotions | List every promotion a listing takes part in or is invited to: promotion id, type, status (candidate, pending, started), the price in the… |
mercado_libre_add_item_to_promotion | Add a listing to a promotion, or accept an invitation, at a promotional price |
mercado_libre_remove_item_from_promotion | Take a listing out of a promotion; it goes back to its normal price |
mercado_libre_list_advertisers | List the Mercado Ads advertiser accounts the signed-in user can reach for Product Ads: advertiser_id, site_id and name |
mercado_libre_search_ad_campaigns | List Product Ads campaigns of an advertiser with their status, budget, strategy and ACOS target and, with a date range and metrics, their… |
mercado_libre_get_ad_campaign | Get one Product Ads campaign: name, status, budget, strategy, ACOS or ROAS target and, with a date range and metrics, its results (clicks… |
mercado_libre_search_product_ads | List the Product Ads (one per promoted listing) of an advertiser with their status and campaign and, with a date range and metrics, each… |
mercado_libre_search_ad_groups | Find the Product Ads ad groups of an advertiser, e.g. the ad group of given listings: returns each ad group's id, name, status, campaign_id… |
Ejemplos de prompts
- "Lista mis publicaciones activas con precio y stock, y marca las que tengan menos de 5 unidades disponibles."
- "Crea una publicación para un Apple iPhone 15 128GB nuevo a R$ 4.999 con 10 unidades en stock. Valídala y muéstrame el resultado antes de publicarla."
- "Baja un 10 % el precio de la publicación MLB1234567890 y actualiza su descripción con el nuevo texto de garantía."
- "Muestra mis pedidos de los últimos 7 días con su estado y total."
- "Lista las preguntas de compradores sin responder en mis publicaciones y redacta un borrador de respuesta para cada una."
- "Para la publicación MLB1234567890, muestra sus visitas de los últimos 30 días, la comisión de venta a su precio actual y el precio con el que ganaría su página de producto del catálogo."
Siguientes pasos
¿Te ha sido útil esta guía?