Mercado Livre Orders MCP. Manage sales and logistics without touching a dashboard.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Mercado Livre Orders connects your AI agent directly to Mercado Livre's order system. You can search for sales by status, get detailed buyer info, manage shipment tracking codes, and handle cancellations—all through natural conversation.
Stop jumping between dashboards; manage every aspect of your e-commerce logistics from one place.
What your AI agents can do
Cancel order
Cancels a sale after verifying that you provide an official reason for the cancellation.
Get feedback
Retrieves specific buyer ratings and comments associated with a given order.
Get order
Pulls all core information—including items, total cost, and status—for one specific sale ID.
Find sales across the entire platform by filtering them based on their current status (paid, shipped, delivered, etc.).
Pull comprehensive data—including buyer info, item lists, and total amounts—for a specific Mercado Livre sale.
Get real-time shipping details for an order, including the carrier name and current tracking code.
Manually set or overwrite a tracking number on a specific shipment record using your own source data.
Execute an official cancellation of a sale, provided you give the system a valid reason for doing so.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Mercado Livre Orders MCP Server: 7 Tools for E-commerce Logistics
These seven tools let your AI client perform every core function of order management—from searching sales to setting tracking codes—directly through the server.
019d75d6cancel order
Cancels a sale after verifying that you provide an official reason for the cancellation.
019d75d6get feedback
Retrieves specific buyer ratings and comments associated with a given order.
019d75d6get order
Pulls all core information—including items, total cost, and status—for one specific sale ID.
019d75d6get shipments
Lists all active shipments linked to a particular order ID.
019d75d6get shipping info
Grabs detailed shipping information for an order, including carrier and tracking codes.
019d75d6search orders
Searches and filters the entire catalog of sales based on multiple criteria like status or date range.
019d75d6set tracking
Updates a shipment record by setting a new, official tracking number for that specific order.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Mercado Livre Orders, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Forget jumping between dashboards trying to figure out what happened with an order. This server connects your AI agent straight into Mercado Livre’s whole order system, giving you full control over everything from initial sale tracking through cancellations and shipping updates. You'll manage every piece of e-commerce logistics right from one place.
Search and Retrieve Order Data
You can find any sale using search_orders, letting your agent filter the entire catalog by date range or current status, whether it’s paid, shipped, delivered, or something else. When you pinpoint a specific sale ID, calling get_order pulls all the core data you need: buyer information, item lists, total amounts, and the order's overall status.
Shipping and Tracking Control
When an order ships, your agent handles it through logistics tools. First, get_shipping_info grabs the detailed shipping rundown for a specific sale—you’ll get the carrier name and the current tracking codes immediately. If you need to know what other shipments are tied to that purchase, get_shipments lists all active shipment records linked to the order ID.
You're not stuck with old numbers; if your source data provides an updated code, calling set_tracking updates the official record by setting a new tracking number for that specific shipment.
Customer Interaction and Management
You need to know what the buyer thinks? Use get_feedback. This tool retrieves specific ratings and comments tied directly to the order. If something goes wrong, your agent can execute an official cancellation of the sale using cancel_order, but you gotta give it a valid reason first—it won't let you cancel without that verification.
How It Works with Your Agent
Your AI client uses these tools to handle complex tasks in natural conversation. For instance, you can tell your agent, "Find me all the paid orders from last week and check their tracking codes." The agent will use search_orders first, then loop through the results using get_shipping_info.
It’s not just reading data; it's taking action. You keep your workflow inside your preferred client—Claude, Cursor, or whatever—and let the server handle the dirty work with Mercado Livre.
Use Cases:
- Monitoring: Ask your agent to find all orders stuck in 'Pending' status and pull their full details using
get_order. - Fulfillment: Tell it to check the tracking for order X, and if it finds a new carrier name, use
set_trackingto update the record immediately. - Problem Solving: If a buyer complains, your agent can fetch their feedback via
get_feedback, and if necessary, initiate a cancellation usingcancel_orderafter confirming the reason.
How Mercado Livre Orders MCP Works
- 1 Subscribe to the server and provide your Mercado Livre OAuth2 Access Token.
- 2 Ask your AI agent a direct question (e.g., 'Show me all orders that need tracking numbers').
- 3 The agent calls the necessary tools (
search_orders,get_shipping_info) and returns structured data you can use immediately.
The bottom line is, your AI client handles the API calls; you just ask for what you need in plain English.
Who Is Mercado Livre Orders MCP For?
Sellers and operations managers who are sick of manually checking dozens of dashboards. If you spend time every day copying tracking numbers or digging through status reports, this is for you. It lets your agent handle the routine data fetching so you can focus on actual growth.
Uses search_orders to monitor daily sales activity and checks buyer feedback with get_feedback without logging into the seller dashboard.
Quickly pulls up full order details using get_order when a customer calls, giving them precise status and tracking info instantly.
Manages the flow of goods by checking shipment statuses (get_shipping_info) and updating tracking numbers via set_tracking in bulk.
What Changes When You Connect
- You check all status changes instantly. Instead of manually logging into the platform, your agent runs
search_ordersto find every sale that needs attention (paid, shipped, etc.). - Support is faster with
get_order. You don't need to copy-paste IDs; you just tell your agent which order and it gets all the buyer details, status, and total amount. - Tracking updates are simple. If a shipment left Mercado Envios, use
set_trackingand give the new code. No more manual form submissions needed. - Handle cancellations correctly. When an order needs to go, you call
cancel_order, and it forces you to provide a valid reason, keeping your records clean. - See buyer sentiment with one prompt. The
get_feedbacktool pulls up the ratings and comments directly, so customer service can react immediately.
Real-World Use Cases
The 'Urgent Shipping' Request
A logistics coordinator needs to know which orders are ready for pickup. They ask their agent: 'What shipments need a tracking number?' The agent runs search_orders filtered by status, then uses get_shipments on the results. Finally, they use set_tracking in bulk for every result.
The Customer Inquiry
A customer support agent gets a call about an old order. They ask their agent: 'What's the status and buyer info for MLB-Order123?' The agent runs get_order to pull all necessary details in one shot, answering the customer without delay.
The Daily Reconciliation
A seller needs a report on recent activity. They ask: 'Show me all orders from last week that were paid but haven't shipped yet.' The agent runs search_orders with date and status filters, giving the full list for review.
The Problem Order
An item was damaged in transit. The seller needs to cancel it. They ask: 'Cancel order MLB-Order456 because of damage.' The agent runs cancel_order, requiring the reason, and updates the status correctly.
The Tradeoffs
Treating all data as one call
Trying to use a general 'update' command for everything. For example, telling your agent to simply 'Change the shipping address on order 123.'
→
You can't just update it. You need specific tools. First, run get_order to confirm details. If the shipment is managed outside Mercado Envios, you must use set_tracking with the correct code.
Ignoring prerequisites
Asking your agent to cancel an order without giving a reason: 'Cancel MLB-Order789.' The call fails because it requires valid input.
→
You must use cancel_order and include the mandatory parameter. For instance, state: 'Please run cancel_order for MLB-Order789 due to buyer default.'
Overlooking shipment scope
Assuming that checking order details (get_order) gives you tracking info. It won't; it just gives the total and items.
→
You need a dedicated tool for shipping data. Use get_shipping_info to get the carrier and code, or use get_shipments to list associated shipments first.
When It Fits, When It Doesn't
Use this server if your primary bottleneck is retrieving, managing, or updating core sales logistics (status changes, tracking codes, order details). It's perfect for sellers who need visibility into the full lifecycle of a sale—from payment to delivery. Don't use it if you are trying to manage inventory levels, handle payments that fail outside Mercado Livre, or process tax documentation; those require different systems. If your problem is 'I can't find the tracking number,' this works. If your problem is 'How do I reconcile my bank statements with sales data?', you need a financial tool instead.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mercado Livre. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 7 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Chasing down order status across multiple dashboards takes forever.
Right now, if an item ships late or the buyer asks for tracking details, you jump between the main dashboard, the shipment tab, and sometimes a carrier's own website. You copy IDs here, paste them there, and wait for three different pages to load just to answer one simple question.
With this MCP server, your agent handles the heavy lifting. Instead of clicking through tabs, you ask: 'What is the tracking code for order 123?' And it runs `get_shipping_info` and gives you the number immediately. Period.
Mercado Livre Orders MCP Server gets your logistics flow running.
The manual steps that vanish are the repetitive data lookups: opening an order ID, then finding the shipment link, and finally copying the tracking number to a spreadsheet. It's tedious, error-prone work done by hand all day long.
Now you just ask your AI client. The agent calls `get_order`, pulls the necessary details, and gives you exactly what you need without you ever touching the Mercado Livre site again.
Common Questions About Mercado Livre Orders MCP
How can I see all my pending orders? +
Use the search_orders tool with status set to 'paid' or 'handling'. It will return a list of orders ready to be shipped.
How do I update the tracking number for a shipment? +
Use the set_tracking action with the Order ID, Shipment ID, Carrier ID, and the Tracking Number.
Can I cancel a sale? +
Yes, use cancel_order. Be aware that cancelling orders can negatively impact your seller reputation metrics.
Can I register an invoice (Nota Fiscal) for a shipment? +
Absolutely. Use the register_invoice tool with the shipment ID, invoice number (NF-e key), and access key. This is required for sellers in Brazil to comply with tax regulations.
How do I use the `get_feedback` tool to check a buyer's reputation? +
The get_feedback tool retrieves the ratings and comments left by buyers for a specific sale. You can quickly assess the seller's history or verify buyer credibility before processing complex orders.
If I need comprehensive details about a single transaction, should I use `get_order`? +
Yes, running get_order pulls all available data for one sale ID. This includes the full buyer profile, the list of items purchased, and the final total amount.
When running `search_orders`, what happens if my OAuth token is expired or invalid? +
The system will return a 401 Unauthorized error. You'll need to refresh your Mercado Livre credentials and re-enter the updated OAuth2 Access Token for the server to function.
Should I use `get_shipments` or `get_shipping_info` to track packages? +
get_shipments lists all shipments tied to an order, giving you an overview. Use get_shipping_info when you need the current status, carrier details, and specific tracking codes for one shipment.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Rocketlane
Deliver customer onboarding projects on time with collaborative workspaces, task tracking, and time-to-value analytics.
Tencent Yuanqi
Orchestrate Tencent Yuanqi AI Agents — manage assistants, trigger conversations, and handle RAG documents directly from any AI agent.
ON24
Host enterprise webinars and virtual events that generate pipeline with interactive engagement tools and first-party intent data.
You might also like
8x8
Power your cloud communications with AI-driven call management, voicemail access, and team messaging across every channel.
Linnworks (E-commerce Ops)
Manage e-commerce operations via Linnworks — audit open orders, track inventory SKUs, and monitor multi-location stock levels.
The Met Museum
Explore 470,000+ artworks from The Metropolitan Museum of Art — search by artist, title, culture, date and department.