How to Use the VTEX Catalog MCP in Claude Code

Q: How do I write a shell script with Claude Code to find products in the VTEX Catalog?

Execute a simple command calling searchproducts. You can specify criteria like brand IDs (b/ID) or category IDs directly in your pipeline for fast results from the VTEX Catalog.

Q: Can I use Claude Code to update stock levels and save product data in the VTEX Catalog?

Yes. Write a script that calls managestock first, then uses saveproduct. The entire sequence runs non-interactively, perfect for GitHub Actions or Docker containers.

Q: Does Claude Code support listing all brands and categories in the VTEX Catalog?

Absolutely. Run getbrand to list brand metadata and getcategory to map out category structures within the VTEX Catalog for auditing purposes.

Q: What is the most reliable way to pull product details from the VTEX Catalog using Claude Code?

Use getproduct when you know the specific ID, or use getsku if your script only has the Stock Keeping Unit. Either command returns clean JSON for piping.

Automate VTEX Catalog updates via headless scripts with Claude Code in the terminal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect VTEX Catalog MCP to Claude Code

Create your Vinkius account to connect VTEX Catalog to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup VTEX Catalog with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Inventory Synchronization Pipelines

Set up a cron job that calls `manage_stock` to sync inventory counts. The output can be piped directly into logging tools or another service. Use this server's functionality to ensure every SKU count is accurate across your systems, eliminating manual checks.

Product Data Bulk Processing

Need to process a list of product IDs? Script it. Run `get_product` for each ID in a loop, then pipe the resulting JSON array into a file or another command. This makes bulk data cleanup and transformation straightforward from any shell script.

Catalog Metadata Extraction

Build an endpoint that first runs `get_category` to list all groups, then uses `get_brand` to list associated brands. The output is clean, structured data. You can also script a targeted search using `search_products`, limiting the results to specific text or ID patterns.

Setup guide

Set up VTEX Catalog MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see vtex-catalog-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest VTEX Catalog transactions." It will automatically discover and invoke the available VTEX Catalog tools.

Terminal

claude mcp add --transport http vtex-catalog-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the VTEX Catalog MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "vtex-catalog-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by VTEX. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect VTEX Catalog now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about VTEX Catalog MCP in Claude Code

Execute a simple command calling `search_products`. You can specify criteria like brand IDs (`b/ID`) or category IDs directly in your pipeline for fast results from the VTEX Catalog.

Yes. Write a script that calls `manage_stock` first, then uses `save_product`. The entire sequence runs non-interactively, perfect for GitHub Actions or Docker containers.

Absolutely. Run `get_brand` to list brand metadata and `get_category` to map out category structures within the VTEX Catalog for auditing purposes.

Use `get_product` when you know the specific ID, or use `get_sku` if your script only has the Stock Keeping Unit. Either command returns clean JSON for piping.

This MCP Server manages product identifiers (SKUs), brand names, category IDs, and inventory counts. These are critical metadata points you'll want to secure in your CI/CD environment.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript