# Mercado Libre MCP > Mercado Libre MCP handles all your e-commerce operations conversationally. List new products, predict categories, manage order statuses, track shipping deadlines (SLAs), and handle customer claims—all without clicking through endless dashboards. Connect your seller account to any AI client and get immediate operational control over your entire marketplace business. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** marketplace, selling, customer-support, logistics, retail ## Description Managing a major online store means juggling dozens of tabs: one for inventory, another for tracking shipments, and yet a third just for responding to buyer questions. This MCP connects your Mercado Libre seller account directly to your agent, letting you manage all those moving parts using natural conversation. Instead of logging into the marketplace dashboard to find out if an item qualifies for promotion or checking status codes for delayed packages, you simply ask. The system handles the complexity. Whether you're updating listings with new attributes, retrieving detailed order metadata, or resolving a post-sale claim, it all happens conversationally. This MCP provides a unified view of your operations, letting support teams handle message flows and logistics coordinators monitor SLA compliance in real time. It’s powerful enough to manage listing creation from scratch while staying simple enough for day-to-day customer service tasks. You access this massive catalog of tools through Vinkius, making it one centralized place to run your entire e-commerce business. ## Tools ### answer_question Provides direct answers to specific questions asked by buyers. ### create_item Publishes a brand new product listing after requiring all necessary details like title, price, and pictures. ### create_test_user Generates temporary user credentials for testing purposes. ### get_claim Retrieves full details about any active post-purchase claim filed by a buyer. ### get_me Pulls up the current user's information from Mercado Libre. ### get_order Gets all detailed metadata for a specific order, including payment and buyer info. ### get_post_sale_messages Retrieves the history of messages exchanged after a sale is completed. ### get_promotion_candidate Checks if an item meets the criteria for running promotions or sales. ### get_return_details Fetches comprehensive details regarding a product that has been returned by a customer. ### get_sale_price Determines the current discounted sale price for any listed item. ### get_shipment_sla Provides the Service Level Agreement deadline required to dispatch a shipment to maintain seller standing. ### get_shipment Retrieves real-time tracking and logistical data for an active shipment. ### get_user_addresses Gets a list of saved physical addresses associated with a specific user profile. ### predict_category Suggests the most appropriate category ID for a product title you provide. ### search_orders Searches across all orders based on specific criteria, like payment status or date range. ### search_questions Finds existing questions asked by buyers to help answer a query without repeating information. ### send_post_sale_message Sends necessary follow-up or update messages after the transaction is completed. ## Prompt Examples **Prompt:** ``` Search for all 'paid' orders for seller ID 123456789. ``` **Response:** ``` I've found 3 paid orders for seller 123456789. The most recent is order #2000001234 for a 'Smartphone XYZ'. Would you like to see the shipment details for this order? ``` **Prompt:** ``` What is the shipping status and SLA for shipment 405928374? ``` **Response:** ``` Shipment 405928374 is currently 'ready_to_ship'. According to the SLA data, you must dispatch this item by tomorrow at 4:00 PM to maintain your reputation metrics. ``` **Prompt:** ``` Predict the best category for a 'Wireless Mechanical Keyboard' on site MLB. ``` **Response:** ``` For 'Wireless Mechanical Keyboard' on MLB (Brazil), the predicted category is MLB271505 (Keyboards). This category has a high probability match for your product title. ``` ## Capabilities ### Create and optimize product listings Predicts the best category for new goods and publishes complete items with all necessary attributes. ### Track order and shipping status Retrieves detailed information on specific orders, including payment status, buyer details, and real-time shipment tracking data. ### Handle customer service messages Searches for common buyer questions, answers them directly, and sends necessary post-sale follow-up messages. ### Manage returns and claims Inspections active post-purchase claims and provides detailed information about product returns to speed up resolutions. ### Check pricing and promotion eligibility Looks up current sale prices for items or determines if a product qualifies for special promotions. ## Use Cases ### A customer asks about shipping delays. The agent uses `get_shipment` with the provided tracking number to pull up the current status. It then checks `get_shipment_sla` and reports back if the delay puts them at risk of poor seller reputation. ### You need to publish a new item quickly. First, you ask the agent to run `predict_category` on your product name. Once the category is confirmed, you use `create_item`, providing all details like quantity and price in one conversational prompt. ### A buyer asks a question that was asked before. The agent uses `search_questions` to find similar past inquiries. It then drafts the correct response using `answer_question`, ensuring the customer gets consistent information without you having to search forums. ### You need to follow up on a completed sale. Instead of sending a manual email, your agent uses `get_post_sale_messages` to see the history. Then it sends a professional update using `send_post_sale_message`. ## Benefits - Stop manually checking dashboards for status updates. Use `get_order` or `search_orders` to instantly pull detailed records on payments, buyer info, and order metadata. - Never miss a shipment deadline again. Check your SLA compliance by running `get_shipment_sla` to ensure you dispatch items on time and protect your seller rating. - Build listings faster. If you're unsure where a product belongs, use `predict_category` first. It suggests the perfect category ID for accurate publishing. - Improve customer service speed drastically. Instead of guessing, run `search_questions` to find common buyer queries and then use `answer_question` to respond immediately. - Keep your inventory updated without logging in multiple times. Use `get_sale_price` to quickly check if an item qualifies for a discount or promotion using `get_promotion_candidate`. ## How It Works The bottom line is you talk to your AI client, and it executes the necessary marketplace action. 1. Subscribe to this MCP and provide your Mercado Libre Access Token. 2. Connect the MCP to any compatible client, like Cursor or Claude. 3. Ask your agent a direct question, such as 'What is the shipment SLA for order 123?' ## Frequently Asked Questions **How do I know if my product can be promoted using the Mercado Libre MCP?** Run `get_promotion_candidate` to check eligibility. The tool will tell you if the item meets the required criteria for running a promotion or sale. **Can I handle buyer questions with the Mercado Libre MCP?** Yes, use `search_questions` first to find common queries, then use `answer_question` to provide immediate and accurate responses directly through your chat interface. **What is the best way to check order status using Mercado Libre MCP?** Use `get_order` with a specific order ID. This retrieves all detailed metadata, letting you see the payment status, buyer information, and more than just a simple 'shipped' flag. **Does Mercado Libre MCP help me manage returns?** Yes. You can use `get_return_details` to pull up all necessary documentation regarding an active product return claim, speeding up your resolution process. **I need to list a new item; which tool do I use first?** Start with `predict_category`. This tool analyzes your product title and suggests the most accurate category ID before you proceed to run `create_item`.