# VTEX Checkout MCP for AI Agents AI Agent Connect

> VTEX Checkout MCP. It lets your AI agent handle the heavy lifting of your VTEX e-commerce checkout process. Simulate carts, calculate shipping, apply coupons, and manage client profiles directly from a chat interface. It turns complex pre-purchase data into conversational actions for your team.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/ai-agent-connect
- **Tags:** cart-simulation, shipping-calculation, checkout-optimization, coupon-management, order-preview, pre-purchase

## Description

VTEX Checkout MCP lets you manage your store's pre-purchase operations through a simple chat interface. When you connect your store to an AI agent, you stop digging through nested admin menus just to answer a simple customer question or test a promotion. Instead of manually calculating how a 20% off coupon interacts with express shipping in a specific zip code, you just ask your agent to run the numbers. It handles the math and the data calls in the background. If a support rep needs to see a customer's saved addresses or verify their profile details, they do not have to switch tabs; the agent pulls that info instantly. You can even simulate entire order flows to see exactly how a cart will look before a customer hits the final buy button. It makes the backend of your store feel like a conversational workspace. Because Vinkius manages the connection, you get this functionality across all your favorite tools without having to build a custom dashboard for every new query. It is about getting the right data at the right time without the friction of a traditional UI. You can verify payment conditions, check coupon impacts, and manage client profiles in one place. This turns a complex backend into a fast, conversational tool for your team.

## Tools

### 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.

### 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.

### 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.

### 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.

### create_address
Add a new shipping address to a specific client profile. This helps keep customer records updated without manual entry.

### get_client_profile
Pull names, emails, and contact details for a registered user. It lets your agent provide instant customer verification.

## Prompt Examples

**Prompt:** 
```
Simulate a cart with 2 units of product ID 1234 and shipping to ZIP 01310-100
```

**Response:** 
```
Cart simulation complete! **Total: R$ 259.80** (2x Widget Pro @ R$ 129.90 each). Shipping options to 01310-100:

- **Standard**: R$ 12.50 (5-7 business days)
- **Express**: R$ 29.90 (1-2 business days)
- **Free Shipping**: eligible (order above R$ 200)
```

**Prompt:** 
```
Apply coupon code SUMMER20 to orderform abc123
```

**Response:** 
```
Coupon **SUMMER20** applied successfully to orderform `abc123`! Discount: **-R$ 51.96 (20% off)**. New total: R$ 207.84. The coupon is now active and will be retained until the order is placed or the cart expires.
```

**Prompt:** 
```
Look up the client profile for user ID 98765
```

**Response:** 
```
Client found: **Maria Silva** (maria@example.com). Document: CPF 123.456.789-00. Phone: +55 11 98765-4321. This client has 3 saved addresses and 12 previous orders.
```

## Capabilities

### Simulate complete order totals
Get instant previews of final prices including discounts and regional shipping costs.

### View active shopping cart states
Retrieve the full list of items and logistics details for any current orderform.

### Apply and test discount coupons
Add coupon codes to active carts to see the immediate impact on the total price.

### Fetch registered customer profiles
Pull names, emails, and contact details for specific user IDs instantly.

### Add new shipping addresses
Register new delivery locations to a client profile without leaving your chat.

### Validate payment conditions
Check payment tokens and conditions before a customer places a real order.

## Use Cases

### Testing a Flash Sale
An e-commerce manager needs to know if a 30% off coupon works with express shipping to a specific region. They ask the agent to simulate_order for 5 items to a specific zip code.

### Live Support Assistance
A customer calls about a missing order. The support rep asks the agent to get_orderform to see the current cart state and get_client_profile to confirm the shipping address.

### Bulk Address Updates
A logistics lead needs to add a new warehouse address to a corporate client. They tell the agent to create_address for user ID 5543.

### Coupon Validation
A marketing lead wants to see the final price of a cart with three different coupons. They use add_coupon repeatedly to see the price drop in real-time.

## Benefits

- Stop manual math: Use simulate_order to instantly see how coupons and shipping interact for any zip code.
- Faster support: Use get_client_profile to pull customer data in seconds instead of hunting through your admin panel.
- Accurate promotions: Test coupon stacking with add_coupon to ensure your discounts work exactly as intended before going live.
- Better data entry: Add new shipping locations to profiles using create_address without leaving your current workflow.
- Pre-purchase validation: Use simulate_payment to check payment conditions before a customer actually tries to check out.
- Real-time cart tracking: Access the current state of any orderform using get_orderform to give customers live updates.

## How It Works

The bottom line is you get a conversational interface for your VTEX checkout data without leaving your chat app.

1. Get your VTEX Account Name, App Key, and App Token from your VTEX Admin settings.
2. Enter these credentials into the Vinkius connection menu to link your store.
3. Ask your agent to simulate a cart or look up a profile to see the data appear in your chat.

## Frequently Asked Questions

**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' 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.

**What happens when a customer asks support about their current cart?**
Your support agent can use the 'get_orderform' tool 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' tool 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.