# VTEX Catalog MCP

> VTEX Catalog MCP connects your AI agent directly to your entire e-commerce product catalog. Manage everything from searching for specific products by brand ID, updating stock levels across warehouses, and creating new listings—all through natural conversation. Stop navigating complex admin dashboards; start talking to your inventory.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** product-catalog, sku-management, inventory-sync, ecommerce-api, product-search, digital-commerce

## Description

Managing a large product line shouldn't feel like operating heavy machinery just to check the price of one shirt. This MCP lets you treat your entire VTEX catalog like an extension of your chat window. Instead of logging into multiple administrative panels, you talk to your agent and it handles the data flow for you. You can run deep searches across all product listings by name or category ID, pulling back pricing, images, and full specs instantly. Need to adjust inventory? Just tell the system which SKU needs more stock, and it updates the count immediately. The power comes from having a single source of truth—the entire catalog—accessible via any MCP-compatible client through Vinkius. You can even create or update products using structured data inputs, ensuring your listings are always current without ever opening the VTEX Admin interface.

## Tools

### get_brand
Retrieves detailed information about a specific brand within the VTEX catalog.

### get_category
Fetches details and structure for any specified product category.

### get_product
Retrieves all specifications, pricing, and metadata for an entire product listing by its ID.

### save_product
Creates a new product or modifies the details of an existing one using structured data provided through your agent.

### search_products
Runs comprehensive searches across the catalog using text keywords, brand IDs, or category IDs.

### get_sku
Looks up detailed attributes, including price and dimensions, for a single stock keeping unit (SKU).

### manage_stock
Updates the available quantity of an SKU in real-time across all defined logistics warehouses.

## Prompt Examples

**Prompt:** 
```
Search for 'Nike Air Max' in my VTEX catalog
```

**Response:** 
```
Found **8 products** matching 'Nike Air Max':

1. **Nike Air Max 90** — R$ 799.90 (3 SKUs: White/Black/Grey)
2. **Nike Air Max 270** — R$ 899.90 (2 SKUs: Black/Red)
3. **Nike Air Max Plus** — R$ 1,099.90 (4 SKUs)

Would you like the full specification sheet for any of these, or check stock levels for a specific SKU?
```

**Prompt:** 
```
Update the stock of SKU 12345 to 150 units
```

**Response:** 
```
Stock updated! SKU **12345** now has **150 units** available in your primary warehouse. The previous balance was 23 units. The inventory change is reflected immediately across all VTEX sales channels.
```

**Prompt:** 
```
Show me the details of category 5678
```

**Response:** 
```
Category **5678** — **Running Shoes**

📂 Parent: Shoes (ID: 1234)
🏷️ Active: Yes
📦 Products: 42 products listed
🔗 URL: /shoes/running-shoes

Would you like to list all products in this category or check a specific brand within it?
```

## Capabilities

### Search and View Products
Find complete product records across your catalog by text search, brand ID, or category ID.

### Retrieve Deep Product Data
Get the full specification sheet for any item, pulling associated SKUs, dimensions, and metadata in one go.

### Maintain Inventory Levels
Adjust the available quantity of specific stock keeping units (SKUs) across all connected warehouses.

### Update Product Listings
Create brand new products or modify existing ones by sending structured product data to the catalog.

### Explore Catalog Structure
Understand your entire business model by getting details on specific brands and categories.

## Use Cases

### A bulk price change across a brand line
The Merchandising team needs to increase the price of all 'Alpha' brand items by 15%. They simply tell their agent, and it executes the necessary API calls using get_brand and save_product multiple times. The entire catalog reflects the change instantly.

### Responding to a sudden stock shortage
The Inventory team notices 20 units of SKU B-789 are critically low. They prompt their agent, which immediately runs manage_stock and updates the count for that specific item in real time, triggering alerts everywhere.

### Researching product details before a meeting
A sales analyst needs to present specs on three different items. They ask their agent to run get_product for each ID, and the system returns a clean, comparative table of dimensions and metadata without manual data gathering.

### Creating a new product line
The catalog manager receives an Excel sheet with 50 new products. Instead of manually entering them, they use save_product to pass the structured data directly through the agent, making all listings live in minutes.

## Benefits

- Inventory updates are instant. Use manage_stock to change stock levels for a SKU across all warehouses without ever opening the VTEX Admin portal.
- Audit your listings faster than ever. The search_products tool lets you pull back full details on any product using just text keywords, brand IDs, or category IDs.
- Keep data accurate by hand. Use save_product to create or update entire products in a structured way directly from your agent chat.
- Understand classification quickly. Get the complete structure and rules for a specific category or brand using get_category or get_brand tools.
- Deep inspection is simple. If you need every detail on an item, use get_product to retrieve the full spec sheet including dimensions and associated SKUs.

## How It Works

The bottom line is you talk to your AI client naturally, and it handles the complex API calls needed to manage product data on VTEX for you.

1. Subscribe to this MCP in Vinkius, then enter your VTEX Account Name, App Key, and App Token (you find these credentials in the Accounts Settings of your VTEX Admin).
2. Select this connector in your AI client. Your agent now has read/write access to your entire product catalog API.
3. Ask a natural language question like, 'Check stock for SKU 90210 and list all products in the running shoes category.' The agent executes the necessary tools and returns the formatted data.

## Frequently Asked Questions

**How do I use VTEX Catalog MCP to find products by keyword?**
You use search_products with a simple text query like 'blue jacket'. The tool runs a full-text search and returns complete listings, including price and availability for all matches.

**Can I update stock levels using the manage_stock tool?**
Yes. You tell your agent which SKU needs how much inventory. The manage_stock tool then updates that quantity in real-time across your connected warehouses, saving you manual admin work.

**Is get_product better than searching for a single item?**
Yes. While search_products finds the listing, using get_product guarantees you receive the complete and detailed specification sheet for that product ID, including all metadata.

**What if I want to create an entirely new product? Do I use save_product?**
That's right. You pass the structured data—like brand name, description, and pricing—to your agent, which then uses save_product to write it directly into the VTEX catalog.

**Can I check category details with get_category?**
Absolutely. You provide a Category ID, and get_category returns the structure, parent IDs, and associated product count, helping you understand your site map quickly.