# VTEX Catalog MCP for AI Agents AI Agent Connect

> VTEX Catalog lets you manage your entire product list through an AI agent. You can search for specific items, update stock levels across multiple warehouses, and create or edit product details without ever opening the VTEX Admin dashboard. It bridges the gap between your store's data and your daily workflow.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_dn6uRbcp7EhBb5ZC2Q019Ev0raY8Wvus89OVghq2/ai-agent-connect
- **Tags:** product-catalog, sku-management, inventory-sync, ecommerce-api, product-search, digital-commerce

## Description

Managing a large e-commerce store usually means jumping between tabs and digging through dense admin panels to find a single SKU or update a price. It is a chore that eats up time. This Connector changes that by letting your AI agent handle the heavy lifting. Instead of clicking through menus, you just tell your agent what needs to happen. You can ask it to find products by name, check if a specific brand is organized correctly, or pull the full specs for a new item. If you need to move stock between warehouses, you just say the word. It updates the quantities in real-time so your sales channels stay accurate. It is a way to make your catalog feel like a conversation rather than a database entry task. By connecting this through the Vinkius catalog, you get a direct line to your VTEX data without the friction of a manual interface. You spend less time on data entry and more time actually running your business.

## Tools

### get_brand
Get the details of a specific brand in your store. This helps you verify brand information quickly.

### get_category
Pull details for a specific category. Use this to see how products are grouped in your hierarchy.

### get_product
Fetch the full specification sheet for a product. It includes all SKUs, categories, and metadata.

### manage_stock
Update the available quantity of a SKU. Use this to sync inventory across your warehouses instantly.

### save_product
Create a new product or update an existing one. This lets you push data changes directly to your catalog.

### search_products
Find products using text, brand IDs, or category IDs. It returns pricing, availability, and images.

### get_sku
Look up a specific SKU for details like weight and dimensions. This is perfect for checking shipping specs.

## Prompt Examples

**Prompt:** 
```
Find all products in my 'Summer Collection' category and tell me their prices.
```

**Response:** 
```
I've pulled the items from your Summer Collection. Here are the current listings:

| Product Name | Price | Availability |
| :--- | :--- | :--- |
| Sun Hat | R$ 89.00 | In Stock |
| Beach Towel | R$ 120.00 | Low Stock |
| Sunglasses | R$ 250.00 | In Stock |

Would you like me to check the stock levels for any of these specifically?
```

**Prompt:** 
```
Update the stock for SKU 998877 to 50 units in the main warehouse.
```

**Response:** 
```
Done! I've updated the inventory for **SKU 998877**. 

*   **New Quantity:** 50 units
*   **Status:** Updated successfully across all sales channels.

Is there anything else you need to adjust today?
```

**Prompt:** 
```
Give me the full specs for product ID 12345.
```

**Response:** 
```
Here are the full specifications for **Product 12345**:

*   **Dimensions:** 20cm x 10cm x 5cm
*   **Weight:** 1.2kg
*   **Categories:** Footwear > Running
*   **Brand:** Nike
*   **Metadata:** Waterproof, Breathable, Size 10

Do you need me to save any changes to these specs?
```

## Capabilities

### Search products by text or ID
Find specific items in your store using plain text, brand IDs, or category IDs.

### Pull full product specifications
Get every detail for a product, including associated SKUs, categories, and metadata.

### Create and update product listings
Push new products to your catalog or edit existing ones directly through your agent.

### Check specific SKU attributes
Look up dimensions, weights, and pricing for individual SKUs instantly.

### Update stock quantities
Adjust the available inventory for any SKU across your warehouses with a simple command.

### Explore category hierarchies
View your full brand directory and category tree to understand your store organization.

## Use Cases

### Fixing stock discrepancies
An inventory lead notices a warehouse mismatch and asks the agent to update SKU 12345 to 150 units using manage_stock.

### Rapid product auditing
A catalog manager wants to see all products in a specific category to check for missing images, using search_products and get_category.

### Quick product creation
A merchandiser needs to add a new item to the store and uses save_product to push the specs from a draft sheet.

### Checking shipping dimensions
A logistics person needs to know the weight of a specific SKU and uses get_sku to get the data for a shipping quote.

## Benefits

- Stop digging through the VTEX Admin. Use search_products to find anything in seconds without navigating complex menus.
- Update inventory instantly. Use manage_stock to change quantities across warehouses without manual data entry.
- Keep your data clean. Use save_product to push updates directly to your catalog from a conversation.
- Audit your catalog structure. Use get_category and get_brand to ensure your hierarchy makes sense.
- Get full product specs fast. Use get_product to see every detail, from dimensions to metadata, in one view.

## How It Works

The bottom line is you get a natural language interface for your entire VTEX product database.

1. Subscribe to the VTEX Catalog MCP.
2. Enter your VTEX Account Name, App Key, and App Token from your VTEX Admin settings.
3. Start asking your agent to find, edit, or update products in your store.

## Frequently Asked Questions

**Can the VTEX Catalog MCP help me manage multiple warehouses?**
Yes, it lets you update stock levels for specific SKUs across your different warehouse locations instantly. This helps keep your inventory synced across all sales channels.

**How does the VTEX Catalog MCP handle product updates?**
You can use it to create new products or update existing ones using natural language. The changes are pushed directly to your store so you don't have to do it manually.

**Can I use VTEX Catalog MCP to search for items by brand?**
Yes, it supports full-text searches including brand IDs and category IDs. This makes it easy to find specific items or audit your brand listings.

**Does the VTEX Catalog MCP work with my current AI agent?**
It works with any MCP-compatible client like Claude or Cursor. This gives your agent direct access to your VTEX store data for faster tasks.

**Can I use VTEX Catalog MCP to see product dimensions?**
Yes, it pulls full specification sheets for products. You can quickly retrieve weights, dimensions, and other metadata for any item in your catalog.

**Is the VTEX Catalog MCP good for auditing my store?**
It is perfect for auditing. You can quickly explore your category tree and brand directory to ensure everything is classified correctly and organized the way you want.

**How do I get my VTEX API credentials?**
Log in to your VTEX Admin, go to **Account Settings → Application Keys**, and create a new App Key. You'll receive an App Key and App Token pair. You also need your Account Name (the subdomain you use to access the VTEX Admin, e.g., 'mystore'). Ensure the key has **Catalog** and **Logistics** read/write permissions. No code, no SDK — just connect and go.

**Can my agent update stock levels without opening the VTEX Admin?**
Yes! Use the 'manage_stock' tool with a SKU ID and the new quantity. Your agent updates the inventory balance in real-time through the VTEX Logistics API — perfect for warehouse teams receiving shipments who need to update stock counts without navigating to the Inventory module.

**How does product search work with categories and brands?**
The 'search_products' tool supports three search modes: full-text (e.g., 'Nike Running Shoes'), by brand ID (e.g., 'b/1234'), or by category ID (e.g., 'c/5678'). This means your agent can quickly audit all products under a specific brand or explore an entire product category — no manual catalog browsing required.

**Can I create new products and manage my entire catalog via AI?**
Absolutely. The 'save_product' tool lets your agent create or update products by sending a structured JSON body. Combined with 'get_category' and 'get_brand' for classification, your agent can handle the full product lifecycle — from initial creation to SKU-level stock adjustments — ideal for merchandising teams managing large VTEX catalogs with thousands of products.