# Mercado Livre Catalog MCP > Mercado Livre Catalog lets you control your entire product presence on Mercado Livre using natural language. You can programmatically create new listings, change prices across hundreds of items, update stock levels instantly, and even find out what attributes a category requires before you publish. It gives your AI client direct access to manage the largest e-commerce ecosystem in Latin America. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** product-listings, stock-control, pricing-strategy, marketplace-management, catalog-management ## Description Managing an online catalog shouldn't feel like logging into ten different seller portals. This MCP lets your agent handle all your product lifecycle needs directly through chat. You can tell it, for example, 'Raise the price of the Model X by 15%' or 'Close out any listing that hasn't sold in a week.' It manages everything from finding top-level categories to getting mandatory details like voltage or size when you publish an item. If your AI client needs reliable access to this data, Vinkius makes it simple. You connect once via the platform and get instant control over listing creation, inventory updates using `update_stock`, pricing adjustments with `update_price`, and even deep searching capabilities through `search_items`. Instead of copying and pasting details into a web form, you just talk to your AI client. This lets you publish products quickly, keep stock counts accurate across the board, or pull up existing product information using `get_item`—all from one conversation. ## Tools ### get_domain_attributes Retrieves a list of required attributes you must include when creating a listing for a specific category. ### get_categories Lists all the top-level product categories available on Mercado Livre Brasil to help you organize new products. ### create_item Publishes a brand new listing for a product, filling in full details and attributes. ### delete_item Deactivates an existing listing by closing it on the marketplace. ### get_item Pulls up all specific details for a single, identified product listing. ### update_price Changes the listed selling price of an existing item to match new market rates. ### search_items Searches for and returns details on other listings that belong to your authenticated user account. ### update_stock Adjusts the available quantity count for a specific item's inventory. ### update_item Makes general changes to a listing, like modifying its title, description, or core attributes. ## Prompt Examples **Prompt:** ``` Update the price of item MLB123456 to R$99.90. ``` **Response:** ``` Price updated successfully! Item is now active at R$99.90. ``` **Prompt:** ``` Create a new listing for a 'Wireless Mouse' in category 'Accessories'. ``` **Response:** ``` Listing created successfully! ID: MLB789012345. It is now live in the site. ``` **Prompt:** ``` What are the mandatory attributes for the Cellphones category? ``` **Response:** ``` Required attributes: Brand, Model, Storage Capacity, Color, Screen Size, RAM. ``` ## Capabilities ### Create and modify listings Publish new items using create_item, or refine existing products by calling update_item. ### Manage pricing across inventory Change product prices dynamically for specific items with update_price. ### Adjust stock levels Update available quantities instantly for any listed item using update_stock. ### Find category requirements Determine mandatory attributes for a specific product domain or category with get_domain_attributes. ### Search and retrieve listing details Search for your own listings using search_items, or pull up the full details of one item with get_item. ## Use Cases ### The seasonal restock An Inventory Manager needs to update 50 different products. Instead of logging into 50 separate product pages, they ask their agent: 'Update stock for all items in the summer gear category by adding 10 units.' The agent runs `update_stock` across multiple SKUs instantly. ### The pricing war response A Digital Marketer sees a competitor's price drop. They tell their agent: 'Check the current prices for my top 5 items and raise any that are below R$150.' The agent uses `search_items` then executes `update_price` on the necessary SKUs. ### The new product launch An E-commerce Seller needs to list a complex electronic item. They first ask, 'What are the required attributes for cellphones?' The agent uses `get_domain_attributes`, and then the seller provides all data to run `create_item`. ### Cleaning up old stock An Inventory Manager wants to remove outdated items. They ask their agent: 'Find all listings marked as obsolete.' The agent runs `search_items` and then uses `delete_item` on the returned list of item IDs. ## Benefits - Stop juggling web tabs. You can use `create_item` to publish new products with full details just by asking your AI client, keeping the whole process conversational. - React instantly to market changes. Use `update_price` whenever a competitor drops their rates; you adjust pricing across multiple items without manual login time. - Keep inventory counts accurate. When an item sells out or a shipment arrives, use `update_stock` to update quantities immediately and reliably. - Build products correctly the first time. Before publishing anything, call `get_domain_attributes` so you never miss a mandatory field like voltage or size. - Audit your catalog easily. Use `search_items` when you need to quickly see all the listings associated with your account for a performance review. ## How It Works The bottom line is that you manage your entire e-commerce inventory from chat commands instead of logging into separate seller dashboards. 1. Subscribe to this MCP on Vinkius and provide your Mercado Livre OAuth2 Access Token. 2. Connect your preferred AI client (like Cursor or Claude) to the catalog via the Vinkius marketplace. 3. Ask your agent a question, like 'Update the price of XYZ item to R$100,' and it executes the necessary tool call. ## Frequently Asked Questions **How do I use the Mercado Livre Catalog to find out what fields are required?** You call get_domain_attributes. This tool reads the marketplace rules for a specific category and tells you exactly which mandatory details, like brand or voltage, must be included in your listing. **Can I update my stock levels using Mercado Livre Catalog?** Yes, absolutely. Use update_stock to adjust the available quantity for any item ID. This is crucial for preventing overselling when inventory changes rapidly. **Is there a way to publish multiple listings at once with Mercado Livre Catalog?** While you'll call create_item for each listing, your agent can manage the flow of data. You feed it the details in one prompt, and it handles publishing them sequentially. **What if I need to change a product title and its description?** You use update_item for general changes like titles or descriptions. This tool lets you modify the core text of a listing without touching the price or stock count. **Does Mercado Livre Catalog let me search all my products?** Yes, you can run search_items to find and pull details on any other listings that belong under your user account. It helps with auditing and reporting.