• STRUCTURE
  • BRANDING
  • ERRORS
  • HUMAN

How to organize catalog categories with your AI

Connect your agent to VTEX to map out your store's hierarchy and find mismatches in your product data.

Ask AI about this page

Short answer

How can I use AI to manage my VTEX catalog structure?

Your agent pulls your current category tree and brand lists to spot gaps or miscategorized items. You'll get a clear view of how your products sit within your existing hierarchy.

Where every issue lands.

Catalog audit outcomes

Your agent identifies these specific areas of your store structure.

STRUCTURE

Category mapping

The AI pulls your full category tree. You'll see exactly how your departments and subcategories are nested.

BRANDING

Brand verification

Check if your brands are correctly registered. The agent confirms which brands exist in your VTEX setup.

ERRORS

Product placement

Find products that don't belong. The AI checks if items are sitting in the right categories.

HUMAN

Manual cleanup

The AI identifies the mess. You'll need to log in to VTEX to actually move or delete categories.

The workflow

What your AI does when the data arrives.

The agent uses your VTEX credentials to read your store's organization.

  1. Map the hierarchy

    The agent pulls your entire category tree to understand your store's layout.

    get_category

  2. Verify brands

    It checks your brand list against your product data to ensure everything matches.

    get_brand

  3. Audit products

    The agent looks up specific items to see where they are currently placed.

    search_products

  4. Identify gaps

    By comparing categories and products, the agent finds missing links or misplaced items.

    get_categorysearch_products

Try it

Copy these to start.

Use these prompts to begin your audit.

Starting points

Replace the bracketed text with your specific category names or brand names.

VTEX Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_dn6uRbcp7EhBb5ZC2Q019Ev0raY8Wvus89OVghq2/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — VTEX capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "vtex-catalog-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_dn6uRbcp7EhBb5ZC2Q019Ev0raY8Wvus89OVghq2/mcp"
    }
  }
}
Copy into chat04

  • List all the top-level categories in my VTEX store.

  • Check if the brand [Brand Name] exists in my catalog.

  • Find all products currently assigned to the [Category Name] category.

  • Are there any products in [Category Name] that don't belong there?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect VTEX Catalog once, then ask.

Just link your account once. Your credentials stay encrypted, and you can start asking questions immediately.

Connect VTEX Catalog to your AI

FAQ

How this task behaves

  • 01

    Can the AI create new categories for me?

    No. The AI can only read your existing category structure.

  • 02

    Can the AI move a product to a different category?

    No. The AI identifies where products are, but you must perform the move in VTEX.

  • 03

    Can I use this to find out which products are out of stock?

    Yes, by searching for products, the agent can see the status of items in your catalog.

  • 04

    Does the AI see my customer data?

    No. This connector only accesses catalog, brand, and product information.

  • 05

    Can the AI delete a brand?

    No. The tools only allow the agent to get and search data, not modify it.

  • More questions about VTEX Catalog? See everything the VTEX Catalog Connector can do

Connect VTEX to Claude, Cursor, ChatGPT & more