VTEX Checkout Connector for AI agents.

Q: 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'). No code, no SDK — just connect and go.

Q: Can my agent simulate a full cart with shipping costs?

Yes! Use the 'simulateorder' tool with a list of items and a postal code. Your agent will return the full cart breakdown — totals, per-item pricing, available logistics options, estimated delivery dates, and applicable discounts — all without touching the actual store.

6 live capabilities

Manage e-commerce carts and shipping costs through a chat interface.

Live agent request VTEX Checkout / Connector

Waiting for input…

AI Agent

Why people use VTEX Checkout

VTEX Checkout for Accurate E-commerce Shipping Calculations

This Connector changes that by letting your agent do the heavy lifting. You just tell the agent the items and the zip code, and it returns the final price, shipping options, and discount totals in one go. You get the answer immediately without the clicks.

What Vinkius changes

You get a conversational interface for your VTEX checkout data without leaving your chat app.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 6,100+ Connectors

Real-world use case 01

Testing a Flash Sale

An e-commerce manager needs to know if a 30% off coupon works with express shipping to a specific region.
Real-world use case 02

Live Support Assistance

A customer calls about a missing order.
Real-world use case 03

Bulk Address Updates

A logistics lead needs to add a new warehouse address to a corporate client.

Complete set · 6capabilities

The complete VTEX Checkout capability set.

These are the exact actions your AI can choose when you ask it to work with VTEX Checkout.

Capability set01 / 02

01—03

3 capabilities in this set.

Part of 6 available through VTEX Checkout.

01 Capability
Add coupon
Apply a discount code to an active shopping cart and see the new total. Use this to test how different codes impact the final price.
02 Capability
Get orderform
Retrieve the full state of a specific shopping cart, including items and logistics. This gives your agent a complete view of what a customer wants to buy.
03 Capability
Simulate payment
Validate payment tokens and check conditions before a real order is placed. It helps your team confirm that payment methods are working correctly.

Capability set02 / 02

04—06

3 capabilities in this set.

Part of 6 available through VTEX Checkout.

04 Capability
Simulate order
Run a full cart simulation to preview totals, discounts, and shipping options. This is the best way to verify pricing for specific regions and products.
05 Capability
Create address
Add a new shipping address to a specific client profile. This helps keep customer records updated without manual entry.
06 Capability
Get client profile
Pull names, emails, and contact details for a registered user. It lets your agent provide instant customer verification.

Set up in minutes

One URL. Then ask VTEX Checkout to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use VTEX Checkout from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it VTEX Checkout, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable VTEX Checkout for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the VTEX Checkout URL.
Step 03

Save and start

Save the connection and enable VTEX Checkout in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "vtex-checkout": {
      "url": "https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using VTEX Checkout

Open Agent mode in chat and ask: "Using VTEX Checkout, help me...". 6 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "vtex-checkout": {
      "url": "https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using VTEX Checkout

Ask Copilot: "Using VTEX Checkout, help me...". 6 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "vtex-checkout": {
      "url": "https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using VTEX Checkout

Open Cascade and ask: "Using VTEX Checkout, help me...". 6 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "vtex-checkout": {
      "url": "https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using VTEX Checkout

Ask Cline: "Using VTEX Checkout, help me...". 6 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add vtex-checkout --transport http "https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using VTEX Checkout

Ask Claude: "Using VTEX Checkout, show me...". 6 tools are ready

Where the request belongs

Work VTEX can move forward.

Built around the request

This is for e-commerce teams who are tired of manual data entry and guesswork during high-traffic sales. It's for the support lead who wants faster answers and the ops manager who needs to verify shipping rules across different regions without opening twenty tabs.

E-commerce Manager

Tests coupon stacking and shipping logic for upcoming flash sales to ensure pricing accuracy.

Customer Support Lead

Retrieves client profiles and orderform details during live chats to provide faster resolutions.

Logistics Coordinator

Validates shipping costs for various postal codes to ensure accurate quotes for different regions.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 6 capabilities

VTEX Orders

Search, track, invoice, and cancel orders on your VTEX store. manage your entire order lifecycle from any AI agent.

View Connector

02 9 capabilities

Elastic Path

Manage headless commerce workflows via Elastic Path. inspect carts, track purchases, and retrieve store navigation directly from any AI agent.

View Connector

03 5 capabilities

Narvar

Streamline post-purchase experiences. track shipments, manage returns, and provide delivery estimates directly through your AI agent.

View Connector

04 10 capabilities

Cart.com (AmeriCommerce)

E-commerce store orchestration via Cart.com. manage products, orders, and customers via AI.

View Connector

05 4 capabilities

Afosto

Retail and e-commerce engine. manage orders, inventory, products, and customers via AI.

View Connector

06 7 capabilities

Shopline

Equip your AI agent to autonomously manage your Shopline store. Audit products, track order fulfillment, fetch customer profiles, and monitor store collections seamlessly.

View Connector

Bring your own AI

Change the model, client or framework. Keep VTEX connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about VTEX.

The practical details behind the request, access and result.

How does the VTEX Checkout MCP help with shipping?

It lets you calculate real-time shipping costs for any postal code. Your agent can preview these costs instantly so you don't have to guess the final price for your customers.

Can I use the VTEX Checkout MCP to test coupons?

Yes. You can apply coupon codes to a simulated cart to see exactly how much they discount the total. This is great for verifying promotions before they go live.

Does the VTEX Checkout MCP show me customer data?

It can pull registered client profiles. This includes names, emails, and contact details, making it much faster for support teams to verify who they are talking to.

Can I add new addresses to customers with the VTEX Checkout MCP?

Yes. Your agent can register new shipping addresses to a client profile directly. This helps keep your records updated without manual data entry in the admin panel.

How do I use the VTEX Checkout MCP for my support team?

Your support team can ask the agent to look up orderforms or customer profiles during a live chat. This gives them the info they need in seconds without switching tabs.

Can the VTEX Checkout MCP simulate real payments?

It can validate payment tokens and check conditions. This helps your team confirm that payment methods are working correctly before a customer completes a real purchase.

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'). No code, no SDK. just connect and go.

Can my agent simulate a full cart with shipping costs?

Yes! Use the 'simulate_order' capability with a list of items and a postal code. Your agent will return the full cart breakdown. totals, per-item pricing, available logistics options, estimated delivery dates, and applicable discounts. all without touching the actual store.

What happens when a customer asks support about their current cart?

Your support agent can use the 'get_orderform' capability to instantly retrieve the customer's active cart. items, quantities, prices, applied coupons, and shipping address. No need to switch tabs or navigate the admin. The agent can then apply a coupon or check shipping costs, all within the same conversation.

Can I validate payment conditions before placing bulk orders?

Absolutely. The 'simulate_payment' capability lets your agent validate payment tokens and check accepted conditions. perfect for operations teams running bulk order validations across multiple sellers and payment methods without processing real transactions.

One connection away

Give your agent a direct line to VTEX.

Connect VTEX once. Keep it beside 6,100+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

VTEX Checkout for Accurate E-commerce Shipping Calculations

You get a conversational interface for your VTEX checkout data without leaving your chat app.

Testing a Flash Sale

Live Support Assistance

Bulk Address Updates

Add coupon

Get orderform

Simulate payment

Simulate order

Create address

Get client profile

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using VTEX Checkout

Create MCP config

Add the server config

Enable Agent mode

Start using VTEX Checkout

Open MCP Settings

Add the server

Save and reload

Start using VTEX Checkout

Open Cline MCP Settings

Add remote server

Enable the server

Start using VTEX Checkout

Install Claude Code

Add the Connector

Verify the connection

Start using VTEX Checkout

E-commerce Manager

Customer Support Lead

Logistics Coordinator

VTEX Orders

Elastic Path

Narvar

Cart.com (AmeriCommerce)

Afosto

Shopline

Give your agent a direct line to VTEX.