Mercado Libre

This connector uses the Mercado Libre REST API (api.mercadolibre.com), one API for every country site. Every endpoint needs the seller's OAuth2 sign-in; unauthenticated calls get 401 or 403.

Setup: in the developer center of your country (https://developers.mercadolibre.com/devcenter) create an application, register the redirect URI <your AnythingMCP URL>/api/mcp-oauth/callback (on AnythingMCP Cloud: https://cloud.anythingmcp.com/api/mcp-oauth/callback) and copy the App ID and the Secret Key into MERCADO_LIBRE_CLIENT_ID and MERCADO_LIBRE_CLIENT_SECRET. MERCADO_LIBRE_SITE_DOMAIN picks the sign-in page of the seller's country (mercadolivre.com.br, mercadolibre.com.ar, mercadolibre.com.mx, mercadolibre.cl, mercadolibre.com.co, mercadolibre.com.pe, mercadolibre.com.uy). Leave the application's notifications callback URL empty and select no topics: Mercado Libre posts notifications there, and the redirect URI above does not accept them. Then authorize the connector with the seller account. Keep the scopes offline_access read write: the listing tools need write.

Site ids: MLB = Brasil, MLA = Argentina, MLM = Mexico, MLC = Chile, MCO = Colombia, MPE = Peru, MLU = Uruguay. Item ids carry the site prefix (MLB1234567890), and so do category ids (MLB1055).

Your seller id: mercado_libre_get_user with user_id me returns the signed-in account; its id is the seller id for mercado_libre_list_seller_items and mercado_libre_list_orders. Seller endpoints only answer for the signed-in seller.

No marketplace search: Mercado Libre refuses its public listing search (/sites/{site_id}/search) to third-party applications with 403, so this connector has none. mercado_libre_list_seller_items lists the signed-in seller's own listings (by status or SKU), and mercado_libre_get_item reads any listing by id.

Creating a listing (there is no sandbox, so whatever is created is live):

1. mercado_libre_predict_category with the product title gives the category_id.
2. mercado_libre_get_category_attributes lists the attributes; send every one tagged required (often BRAND, MODEL, GTIN). mercado_libre_get_category_sale_terms gives the warranty fields and mercado_libre_list_listing_types the listing types (gold_special = classic, gold_pro = premium). mercado_libre_get_category has the limits: max_title_length, max_pictures_per_item, minimum_price.
3. mercado_libre_validate_listing with the full listing; an empty answer means it would be accepted. A 400 whose causes are all type: warning also means it would be accepted; only causes of type: error block it.
4. mercado_libre_create_listing, then mercado_libre_add_listing_description with the text.

Title or family_name: sellers on the User Products model (most sellers since 2025) send family_name, a generic product name such as 'Apple iPhone 15 128GB', and no title: Mercado Libre writes the title itself. Sellers still on the old model send title. The error 'The fields [title] are invalid' means: send family_name instead. A listing that has a family_name does not accept title changes.

Changing listings: mercado_libre_update_listing changes price, stock, pictures, attributes and sale terms (send only what changes; pictures and attributes replace the whole list). Stock 0 pauses the listing until stock comes back. mercado_libre_set_listing_status pauses or reactivates, mercado_libre_update_listing_description replaces the text. Title, condition and buying mode are locked once a listing has sales. mercado_libre_close_listing ends a listing for good and is installed switched off. Every write acts on the live shop: confirm each one with the user.

Rate limits: Mercado Libre answers 429 when an application sends too many requests. Wait before retrying and do not fire many listing changes in parallel.