VTEX Orders Connector for AI agents.
6 live capabilities
Manage your e-commerce order lifecycle and fulfillment from your AI client.
Waiting for input…
Why people use VTEX Orders
VTEX Orders for Automated E-commerce Fulfillment
This Connector changes that by letting you do it all through a simple chat. You just tell your agent which order you need, and it pulls the data instantly. You can move batches of orders forward or register invoices with one command. You get your time back to focus on growing the business instead of babysitting the dashboard.
What Vinkius changes
You get a direct line to your VTEX order data without leaving your chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Instant refund for a wrong size
A customer wants to cancel an order because they chose the wrong size.
- Real-world use case 02
Batch moving orders to handling
A fulfillment lead sees 20 orders ready for packing.
- Real-world use case 03
Finding stuck orders
An ops manager needs to find all orders that haven't moved in 24 hours.
Complete set · 6capabilities
The complete VTEX Orders capability set.
These are the exact actions your AI can choose when you ask it to work with VTEX Orders.
01—03
3 capabilities in this set.
Part of 6 available through VTEX Orders.
- 01 Capability
Register invoice
Attach a tax invoice and tracking number to an order. This automatically moves the order to an Invoiced status.
- 02 Capability
Search orders
Search for orders based on their current status. It includes pagination to handle large volumes of data easily.
- 03 Capability
Update order status
Change the status of an order to move it through the fulfillment pipeline. Use this to push orders to the next stage.
04—06
3 capabilities in this set.
Part of 6 available through VTEX Orders.
- 04 Capability
Get tracking info
Get the carrier, tracking number, and URL for a shipped package. This lets you share real-time info with customers quickly.
- 05 Capability
Cancel order
Cancel a specific order and log the reason. This triggers the automatic refund process for the customer.
- 06 Capability
Get order
Retrieve the full details of an order using its ID. You will see everything from the items to the payment method.
Set up in minutes
One URL. Then ask VTEX Orders to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use VTEX Orders from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/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 Orders, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable VTEX Orders for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/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 Orders URL.
- Step 03
Save and start
Save the connection and enable VTEX Orders in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"vtex-orders": {
"url": "https://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/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 Orders
Open Agent mode in chat and ask: "Using VTEX Orders, help me...". 6 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"vtex-orders": {
"url": "https://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/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 Orders
Ask Copilot: "Using VTEX Orders, help me...". 6 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"vtex-orders": {
"url": "https://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/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 Orders
Open Cascade and ask: "Using VTEX Orders, help me...". 6 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"vtex-orders": {
"url": "https://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/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 Orders
Ask Cline: "Using VTEX Orders, help me...". 6 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add vtex-orders --transport http "https://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/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 Orders
Ask Claude: "Using VTEX Orders, show me...". 6 tools are ready
Where the request belongs
Work VTEX can move forward.
This is for fulfillment leads who are tired of manual data entry, support agents who need instant order info, and ops managers who need to audit order flows without clicking through dozens of pages.
Fulfillment Manager
Uses the Connector to move batches of orders through the pipeline and register invoices without manual status flipping.
Customer Support Agent
Quickly pulls tracking info and order details during live chats to give customers immediate answers.
Operations Manager
Audits order flow and identifies bottlenecks by searching for specific order statuses across the store.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsVTEX Checkout
Simulate carts, calculate shipping, apply coupons, and manage client profiles on your VTEX store. all from any AI agent.
Extensiv
Manage omnichannel operations via Extensiv. track orders and shipments, monitor inventory and warehouses, and manage vendors directly from any AI agent.
VTEX Catalog
Search products, manage SKUs, update stock levels, and explore categories and brands on your VTEX store. all from any AI agent.
Order Desk
Route and manage orders from multiple sales channels to fulfillment providers with automation rules that handle the complexity.
Megaventory
Inventory and order management via Megaventory. track products, stock levels, and orders.
Duoplane
Equip your AI agent to manage multi-vendor orders, track purchase orders, and monitor vendor inventory via the Duoplane API.
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.
Can the VTEX Orders MCP handle order cancellations?
Yes, it can cancel orders directly. When you do this, it also logs the reason and automatically triggers the refund process for your customer.
How do I use VTEX Orders MCP to update shipping info?
You can use the Connector to pull tracking numbers and carrier URLs instantly. Your agent can then provide these details to your customers without you having to look them up manually.
Does VTEX Orders MCP support large order volumes?
Yes, it includes built-in pagination. This allows your agent to search through and manage large lists of orders without hitting limits or missing data.
Can I use VTEX Orders MCP to register tax invoices?
Yes, you can register tax invoices and tracking numbers through the Connector. This will automatically move the order to 'Invoiced' status in your store.
Is VTEX Orders MCP good for customer support?
It's a great capability for support teams. It lets agents quickly check order details and tracking info during live conversations, leading to faster resolutions.
How do I connect VTEX Orders MCP to my AI client?
Just subscribe to the Connector and enter your VTEX Account Name, App Key, and App Token from your Admin settings. Once connected, your agent can start managing orders.
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 OMS read/write permissions. No code, no SDK. just connect and go.
Can my agent register an invoice and tracking number at the same time?
Yes! The 'register_invoice' capability accepts the invoice number and an optional tracking number in one call. Once submitted, the order automatically moves to 'Invoiced' status. eliminating the manual step of navigating to the VTEX Admin, opening the order detail, and filling each field separately.
How does the agent handle order cancellations with refunds?
Just tell your agent to cancel the order. It uses the 'cancel_order' capability with an optional reason (so your team has an audit trail). VTEX then handles the refund automatically based on the payment method. No tab-switching, no admin navigation. your support team resolves it in one conversation.
Can I monitor fulfillment status across hundreds of orders?
Absolutely. The 'search_orders' capability supports status filters and pagination, so your agent can scan the entire order queue. for example, listing all orders stuck in 'ready-for-handling' to identify fulfillment delays. Perfect for operations teams managing high-volume VTEX stores with multiple sellers.
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