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.
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
- Open the developer center of your country at
https://developers.mercadolibre.com/devcenterand create an application. - Register the redirect URI
https://cloud.anythingmcp.com/api/mcp-oauth/callbackexactly as written. If you host AnythingMCP yourself, it is<your AnythingMCP URL>/api/mcp-oauth/callback. - Copy the App ID into
MERCADO_LIBRE_CLIENT_IDand the Secret Key intoMERCADO_LIBRE_CLIENT_SECRET. - Set
MERCADO_LIBRE_SITE_DOMAINto your country site:mercadolivre.com.br,mercadolibre.com.ar,mercadolibre.com.mx,mercadolibre.cl,mercadolibre.com.co,mercadolibre.com.peormercadolibre.com.uy. It decides which country's sign-in page opens. - 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:
- Predict the category from the product title.
- 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.
- Validate the complete listing without publishing it.
- 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 showsYOUR_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.
- In Copilot Studio, open your agent (or create one), go to Tools and choose Add a tool → New tool → Model Context Protocol.
- Enter a Server name (for example
AnythingMCP), a Server description that says what the connector does, and the Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio uses the description to decide when to call the server. - Under authentication, choose API key, set Type to Header and the header name to
X-API-Key, then select Create. - 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.
- Try it in the agent's Test pane: ask for something that needs the
Mercado Libretools. - 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
| 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… |
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
- Connector landing page
- Connect to Claude
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Meta Muse
Was this guide helpful?