Search for products on MercadoLibre across a site (public data — any authenticated profile can read it, regardless of which country it belongs to).

Usage examples:

• "Find iPhone 15 in Argentina" → query="iPhone 15", site_id="MLA"

• "Search for zapatillas running under 5000 pesos in Uruguay" → query="zapatillas running", price_max=5000, site_id="MLU"

• "Find laptops in Brazil" → query="notebook", site_id="MLB"

Get full details of a MercadoLibre listing by its item ID.

site_id selects which authenticated profile executes the call — since item details are public catalog data, any authenticated country profile can read an item regardless of which country it was published in.

Usage examples:

• "Get details for MLA1234567890"

• "Show me the listing information for MLB987654321"

Create a new product listing on MercadoLibre.

Requires OAuth2 write scope on the profile matching site_id — that profile's authenticated account is the one that will own the new listing. Use predict_category/list_categories first to find valid category IDs.

Usage examples:

• "Create a listing for an iPhone 15 at 1500 ARS in category MLA1051" → site_id="MLA"

• "Publish a new running shoes product in Uruguay for 2500 UYU" → site_id="MLU"

Update an existing MercadoLibre listing. Only provided fields are changed.

Important: site_id must match the country whose authenticated profile actually OWNS this item, or the API will reject the write (403).

Usage examples:

• "Update the price of MLA1234567890 to 2000" → site_id="MLA"

• "Change stock of item MLU987654321 to 50 units" → site_id="MLU"

Close/finish a MercadoLibre listing. Sets status to 'closed'. Items can be relisted later.

Important: site_id must match the country whose authenticated profile actually OWNS this item, or the API will reject the write (403).

Usage examples:

• "Remove listing MLA1234567890" → site_id="MLA"

• "Finish my ad for MLU987654321" → site_id="MLU"

List all items owned by the authenticated user for a given country profile.

Usage examples:

• "Show all my active listings in Argentina" → site_id="MLA"

• "List my paused items in Uruguay" → site_id="MLU"

Relist a previously closed item as a new listing.

Usage examples:

• "Relist MLA1234567890" → site_id="MLA"

• "Republish my finished ad with 10 units available" → site_id="MLU"

Get all top-level categories available on a MercadoLibre site.

Usage examples:

• "What categories are available in Argentina?" → site_id="MLA"

• "List categories for Uruguay" → site_id="MLU"

Get detailed information about a specific category, including its children and attributes.

Usage examples:

• "Tell me about category MLA1051"

• "What are the attributes for category MLU1000?"

Predict the best matching MercadoLibre category for a given product title.

Usage examples:

• "Which category should I use for 'iPhone 15 Pro Max 256GB'?" → site_id="MLA"

• "Predict category for 'Zapatillas Nike Running Hombre'" → site_id="MLU"

Search orders for the authenticated seller in a given country.

Requires OAuth2 with read scope.

Usage examples:

• "Show me my recent orders in Argentina" → site_id="MLA"

• "List my paid orders in Uruguay" → site_id="MLU"

• "Get orders that are pending shipment"

Get detailed information about a specific order.

Usage examples:

• "Show me details for order 1234567890" → site_id="MLA" (or wherever the order lives)

Get available shipping methods for an item to a destination zip code.

Usage examples:

• "What shipping options are available for item MLA123 to zip 11000?"

Get tracking information for a shipment.

Usage examples:

• "Track shipment 987654321"

List questions asked about items, optionally filtered by item or status.

Usage examples:

• "Show me unanswered questions for my items" → site_id="MLA"

• "List questions about item MLU1234567890"

Answer a pending question about an item.

Usage examples:

• "Answer question 98765 with 'Yes, we have stock'"

Get public profile and seller reputation for a MercadoLibre user.

Leave user_id empty to get the authenticated user's own profile for site_id.

Usage examples:

• "What's my MercadoLibre profile in Argentina?" → site_id="MLA"

• "Show seller reputation for user 123456789"

List Mercado Ads campaigns for the authenticated seller in a given country.

Requires OAuth2. Mercado Ads must be enabled for the account.

Usage examples:

• "Show my active advertising campaigns" → site_id="MLA"

• "List my Mercado Ads campaigns in Uruguay" → site_id="MLU"

Get visit statistics for a MercadoLibre listing.

Usage examples:

• "How many views does MLA1234567890 have?"

• "Show me last week's visits for item MLU987654321" → last_week=true

List which MercadoLibre country profiles are authenticated and ready to use, and which of the 18 supported sites are NOT yet authenticated.

This does not create any client or make any API call — it only inspects locally cached OAuth profiles under ~/.mercadolibre_mcp/profiles/.

Usage examples:

• "Which countries am I authenticated in?"

• "Show me my connected MercadoLibre accounts"

• "Am I set up for Uruguay yet?"