# Mercado Livre Orders MCP > Mercado Livre Orders MCP gives your AI client full control over order fulfillment and sales logistics directly from Mercado Livre. Search for any sale by status, get detailed buyer info, manage shipments, update tracking codes, and handle cancellations—all through natural conversation. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** order-tracking, shipment-management, sales-processing, invoice-management, cancellation-handling ## Description You can use this MCP to take manual effort out of managing e-commerce orders. Instead of logging into dashboards or copying data across multiple tabs, you tell your AI agent what needs doing. It then connects directly to Mercado Livre to find the information or execute the action for you. Need to know the status of a specific item? Ask it. Want to see all sales that are ready for shipping? Just ask. This capability is critical for anyone handling high volumes of transactions, letting your AI client manage everything from checking buyer feedback to updating tracking numbers and even filing cancellations when necessary. When you connect this MCP through Vinkius, you get a central place to access this tool alongside thousands of others, giving your team complete logistical oversight. ## Tools ### cancel_order Cancels a sale on the platform after you provide an acceptable reason. ### get_feedback Retrieves buyer ratings and comments for a specific completed order. ### get_order Pulls all detailed information about one single sale, including items and the total cost. ### search_orders Finds multiple sales by filtering them using their current status (paid, delivered, etc.). ### get_shipments Lists all associated shipments linked to a specific order number. ### get_shipping_info Gets detailed shipping information, including the carrier and tracking status for an order. ### set_tracking Assigns a tracking number to a shipment record you handled outside of Mercado Envios. ## Prompt Examples **Prompt:** ``` Show me all orders that need shipping. ``` **Response:** ``` Found 3 orders ready for shipping: 1. MLB-Order123 (R$150.00). 2. MLB-Order456 (R$89.90). 3. MLB-Order789 (R$210.00). ``` **Prompt:** ``` Get details for order MLB-Order123. ``` **Response:** ``` Order MLB-Order123: Status: Paid. Buyer: João Silva. Total: R$150.00. Item: Wireless Headphones. ``` **Prompt:** ``` Register invoice 9999 for shipment 12345 with tracking XYZ. ``` **Response:** ``` Invoice registered successfully! Tracking code XYZ set for shipment 12345. ``` ## Capabilities ### Find specific sales Search for orders across the platform using filters like paid, shipped, or delivered. ### Retrieve order details Get comprehensive information on any sale, including buyer data and item totals. ### Manage shipping status View current shipment statuses, carrier names, and associated tracking codes for an order. ### Update logistics records Set a new tracking number or register an invoice against a specific shipment. ### Handle cancellations Cancel an existing sale through the platform after providing a valid reason. ### Check buyer reputation Retrieve feedback and ratings left by customers for completed sales. ## Use Cases ### A customer calls asking about their package status. Instead of promising to check and then having to log in manually, your agent uses 'get_order' first, then 'get_shipping_info'. It pulls the current carrier tracking details and reads them out loud immediately. ### The seller needs to process a large batch of sales records. They ask the agent to 'search_orders' for all items marked as paid but not yet shipped. The agent returns the list, which allows the logistics team to pull the necessary details and update them. ### A sale needs to be canceled due to inventory issues. The seller directs the agent to 'cancel_order', making sure to input a specific reason. The MCP executes this, preventing manual errors or delays in updating the platform status. ## Benefits - Stop manual dashboard checks. Use 'search_orders' to instantly pull lists of all pending or paid sales, letting your agent do the filtering work for you. - Instantly answer buyer questions. With 'get_order', you retrieve full sale details—buyer name, item list, and total—in seconds, without ever logging into a support portal. - Handle shipping updates efficiently. If you get tracking codes from a third party, use the MCP to update them with 'set_tracking' across multiple orders instantly. - Keep records clean. Use 'get_shipments' followed by 'get_shipping_info' to view carrier details and status, ensuring your internal logs match the platform data. - Protect yourself from disputes. You can use 'cancel_order' when necessary, but you must provide a valid reason for the action. ## How It Works The bottom line is that once connected, you can control complex order actions using simple conversation prompts. 1. Subscribe to the Mercado Livre Orders MCP within Vinkius. 2. Enter your required Mercado Livre OAuth2 Access Token into the connection settings. 3. Start giving commands using your AI client, directing it to manage sales and logistics. ## Frequently Asked Questions **How do I find out which orders are ready to be shipped using Mercado Livre Orders MCP?** You use the 'search_orders' tool, filtering by status like 'paid'. This will return a list of relevant sale IDs that you can then process further. **Can I update tracking numbers manually with the Mercado Livre Orders MCP?** Yes. After confirming the shipment details using 'get_shipments', you use 'set_tracking' to register your carrier's code for that specific order. **Does this MCP help me manage buyer complaints?** It helps by letting you access crucial data. Use 'get_feedback' to pull the customer's history, giving you context before responding to a complaint. **Is cancellation difficult with Mercado Livre Orders MCP?** No. The 'cancel_order' tool handles cancellations but requires you to provide a valid reason in your prompt to ensure the action goes through correctly. **What if I need all the details for one specific order?** Use the 'get_order' tool. It pulls every piece of information—buyer, items, totals—into a single data packet for your agent to read out or process.