Connector guide12-minute read41 MCP tools7 languages

Connect Mercado Libre to Microsoft Copilot via MCP

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.

HCBy HelpCode teamUpdated 12 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Mercado Libre

Mercado Libre

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.

tools

41

Region

BR

Category

E-commerce

Authentication

OAuth 2.0

Required env vars

MERCADO_LIBRE_CLIENT_IDMERCADO_LIBRE_CLIENT_SECRETMERCADO_LIBRE_SITE_DOMAIN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.

Guided setup

Connect Mercado Libre to Microsoft Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Mercado Libre in the guided setup, then add your MCP URL to Microsoft Copilot. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Mercado Libre

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Mercado Libre · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Mercado Libre, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Mercado Libre + Microsoft Copilot

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

MERCADO_LIBRE_CLIENT_ID, MERCADO_LIBRE_CLIENT_SECRET, MERCADO_LIBRE_SITE_DOMAIN

Step 1 — Get credentials

  1. Open the developer center of your country at https://developers.mercadolibre.com/devcenter and create an application.
  2. Register the redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback exactly as written. If you host AnythingMCP yourself, it is <your AnythingMCP URL>/api/mcp-oauth/callback.
  3. Copy the App ID into MERCADO_LIBRE_CLIENT_ID and the Secret Key into MERCADO_LIBRE_CLIENT_SECRET.
  4. Set MERCADO_LIBRE_SITE_DOMAIN to your country site: mercadolivre.com.br, mercadolibre.com.ar, mercadolibre.com.mx, mercadolibre.cl, mercadolibre.com.co, mercadolibre.com.pe or mercadolibre.com.uy. It decides which country's sign-in page opens.
  5. Install the connector, click Authorize with Provider and sign in with the seller account. Keep the scopes offline_access read write: the listing tools need write.

Sites and ids: MLB is Brasil, MLA Argentina, MLM Mexico, MLC Chile, MCO Colombia, MPE Peru and MLU Uruguay. Item and category ids carry the site prefix, such as MLB1234567890. Seller tools answer only for the signed-in seller; mercado_libre_get_user with me returns your seller id.

Creating a listing: Mercado Libre has no sandbox, so a new listing goes live and can sell at once. The AI follows the listing flow:

  1. Predict the category from the product title.
  2. Read the category's attributes (send every required one, often brand, model and GTIN), its warranty terms, the listing types (gold_special is classic, gold_pro premium) and its limits, such as the maximum title length, the number of pictures and the minimum price.
  3. Validate the complete listing without publishing it.
  4. Create the listing, then add its description as plain text.

family_name or title: sellers on the User Products model, which covers most sellers since 2025, send a family_name, a generic product name such as "Apple iPhone 15 128GB", and no title: Mercado Libre then writes the title itself. Sellers still on the older model send title. The error "The fields [title] are invalid" means you need family_name. A listing that has a family_name does not accept title changes.

Changing listings: price, stock, pictures, attributes and sale terms can be changed; pictures and attributes replace the whole list. Stock 0 pauses a listing until stock comes back. Listings can be paused and reactivated, and their description replaced. Title, condition and buying mode are locked once a listing has sales.

Confirm first: every write acts on your live shop, so the AI confirms each one with you. Three tools are switched off at install: mercado_libre_close_listing, which ends a listing for good (pausing is the reversible alternative), mercado_libre_post_answer and mercado_libre_remove_item_from_promotion.

Orders, fees, questions, promotions and Product Ads: the AI also reads single orders and the shipping cost of their shipment, works out the selling fee for a price and what free shipping would cost you, and reads up to 20 listings at once. It shows the visits of your listings, the most searched keywords of a category and, for catalog listings, the other sellers on the same product page and the price that would win it. It lists buyers' unanswered questions, reads your promotion invitations and campaigns, adds a listing to a promotion, and reads your Product Ads campaigns, ads and metrics (up to 90 days back; Product Ads must be enabled in Mercado Ads). mercado_libre_post_answer is switched off because an answer is public on the listing at once and cannot be edited, and mercado_libre_remove_item_from_promotion because the listing goes back to its normal price. Switch them on deliberately on the connector page; the AI asks before every change.

Already installed? The new tools reach a connector you installed earlier through its catalog update: open the connector in AnythingMCP and, under Catalog update available, check the list of new tools and click Apply update. Your credentials and any tools you added yourself stay as they are, and the close, answer and promotion-removal tools arrive switched off, as on a new install.

Rate limits: Mercado Libre answers 429 when an application sends too many requests, so large batches of listing changes run one after another, not in parallel.

Step 2 — Install the adapter

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

Step 3 — Add the connector in Microsoft Copilot

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Microsoft Copilot uses MCP servers through agents built in Copilot Studio: you add AnythingMCP to an agent as a tool, then publish the agent to Microsoft 365 Copilot and Teams. Copilot Studio connects from Microsoft's cloud over Streamable HTTP, which AnythingMCP supports.

  1. In Copilot Studio, open your agent (or create one), go to Tools and choose Add a tool → New tool → Model Context Protocol.
  2. Enter a Server name (for example AnythingMCP), a Server description that says what the connector does, and the Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio uses the description to decide when to call the server.
  3. Under authentication, choose API key, set Type to Header and the header name to X-API-Key, then select Create.
  4. In Add tool, choose Create a new connection, paste an MCP API key from AnythingMCP (MCP Servers → your server → API keys) and select Add to agent.
  5. Try it in the agent's Test pane: ask for something that needs the Mercado Libre tools.
  6. Select Publish, then Channels → Microsoft 365 and Microsoft Teams, keep Make agent available in Microsoft Copilot selected and choose Add channel. See agent in Teams installs it for you; in Microsoft 365 Copilot, type @ and pick the agent.

Prefer per-user sign-in? Choose OAuth 2.0 → Dynamic discovery instead of an API key: each user then signs in to AnythingMCP the first time the agent calls it.

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Copilot Studio connects from Microsoft's cloud, so localhost does not work.

Available tools

ToolWhat it does
mercado_libre_get_itemFetch full details for a Mercado Libre item by id
mercado_libre_get_userGet a user's public profile (typically used to inspect a seller)
mercado_libre_list_ordersList orders for an authenticated seller
mercado_libre_predict_categorySuggest the category for a new listing from its title (the category predictor)
mercado_libre_get_categoryRead 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_attributesList the attributes (technical specifications) of a category: id, name, value_type, allowed values with their value_id, and tags
mercado_libre_get_category_sale_termsList 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_typesList the listing types of a site (e.g. gold_pro, gold_special, free) with their names
mercado_libre_list_seller_itemsList the ids of a seller's listings, 50 per page by default (max 100), optionally filtered by status or SKU
mercado_libre_validate_listingCheck a new listing without publishing it
mercado_libre_create_listingPublish a new listing on the seller's account; it goes live and can sell at once
mercado_libre_update_listingChange a listing: price, stock (available_quantity), pictures, attributes, sale terms, video or shipping
mercado_libre_set_listing_statusPause a listing (hidden from buyers, can be reactivated) or reactivate a paused one
mercado_libre_close_listingEnd a listing for good (status closed)
mercado_libre_get_listing_descriptionRead the description text of a listing (plain_text), with its creation and update dates
mercado_libre_add_listing_descriptionAdd the description to a listing that has none yet, typically right after mercado_libre_create_listing
mercado_libre_update_listing_descriptionReplace the description of a listing
mercado_libre_get_itemsRead up to 20 listings in one call (items multiget)
mercado_libre_get_orderGet one order by id: status, date, buyer nickname, order_items (listing, variation, quantity, unit price), payments, total_amount, shipping…
mercado_libre_get_shipment_costsGet 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_costQuote 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_pricesWork 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_visitsGet the total visits of one or more listings between two dates
mercado_libre_get_item_visits_by_dayGet the daily visits of one listing over the last N days (time window up to 150 days)
mercado_libre_get_productGet a catalog product by id: name, family, attributes, pictures, main features, the domain and buy_box_winner (the listing currently…
mercado_libre_list_product_itemsList 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_winCheck how a catalog listing competes for the product page: status (winning, sharing_first_place, competing, listed), price_to_win (the…
mercado_libre_get_category_trendsGet the most searched keywords of a category on a site, by recent growth and volume
mercado_libre_search_questionsSearch buyers' questions on the seller's listings: by seller (all listings) or by one listing, optionally only UNANSWERED ones
mercado_libre_post_answerPublish the seller's answer to a buyer's question on a listing
mercado_libre_list_seller_promotionsList the promotions the seller is invited to or runs (seller-promotions API): id, type (DEAL, MARKETPLACE_CAMPAIGN, PRICE_DISCOUNT…
mercado_libre_get_promotionGet the details of one promotion: name, type, status, dates, deadline to join, benefits and, for seller campaigns, the discount rules
mercado_libre_list_promotion_itemsList the seller's listings in a promotion with their status there (candidate = invited, pending, started, finished), price and…
mercado_libre_get_item_promotionsList 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_promotionAdd a listing to a promotion, or accept an invitation, at a promotional price
mercado_libre_remove_item_from_promotionTake a listing out of a promotion; it goes back to its normal price
mercado_libre_list_advertisersList the Mercado Ads advertiser accounts the signed-in user can reach for Product Ads: advertiser_id, site_id and name
mercado_libre_search_ad_campaignsList 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_campaignGet 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_adsList 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_groupsFind 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…

Example prompts

  • "List my active listings with price and stock, and flag the ones with fewer than 5 units left."
  • "Create a listing for a new Apple iPhone 15 128GB at R$ 4.999 with 10 in stock. Validate it and show me the result before publishing."
  • "Lower the price of listing MLB1234567890 by 10% and update its description with the new warranty text."
  • "Show my orders from the last 7 days with their status and total."
  • "List the unanswered buyer questions on my listings and draft a reply for each one."
  • "For listing MLB1234567890, show its visits over the last 30 days, the selling fee at its current price and the price that would win its catalog product page."

FAQ

Which Copilot is this for? Microsoft 365 Copilot at work, through agents built in Copilot Studio. The Microsoft Copilot app for personal accounts has no option to add your own MCP server.

What do I need? A work account with access to Copilot Studio (a license or a trial) to build the agent. People who use it in Microsoft 365 Copilot or Teams need access to the agent: share it with them, or ask an admin to publish it to the organization. If your organization applies data policies to Power Platform connectors, they cover MCP servers too.

The agent doesn't call the tools. Check that the header name is exactly X-API-Key and that the key belongs to the same MCP server as the URL, and make the server description specific: Copilot Studio uses it to decide when to call the server. Publish the agent again after each change; in an open chat, type "start over" to get the new version.

Next steps

Was this guide helpful?

Connect Mercado Libre to Microsoft Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Mercado Libre in the guided setup, then add your MCP URL to Microsoft Copilot. No code and no server to run.

Related guides

Connectors

Connect Mercado Libre to Meta Muse via MCP

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.

Connectors

Connect Mercado Libre to ChatGPT via MCP

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.

Connectors

Connect Mercado Libre to Claude via MCP

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.

Connectors

Connect Mercado Libre to Cursor via MCP

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.

Connectors

Connect Mercado Libre to Gemini CLI via MCP

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.

Connectors

Mercado Libre MCP Server: Listings, Orders and Ads

LATAM's largest marketplace: read items, catalog products and their competing listings, orders, shipping costs, fees, visits, trends and buyer questions, manage the seller's own listings (create, validate, change price, stock and description, pause or close) and promotions, and read Product Ads campaigns and metrics on Brasil (MLB), Argentina (MLA), Mexico (MLM), Chile (MLC), Colombia (MCO), Peru (MPE) and Uruguay (MLU). Sign in with the seller's Mercado Libre account.