Connectors · Accounting & finance
VTEX MCP server for AI agents.
actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to VTEX and the rest of your systems. It gives your agent 932 VTEX actions (423 reads, 375 writes and 134 that wait for a confirmation) and holds the VTEX credential itself, so the agent never does. It paces VTEX's limits and records every call.
100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.
claude mcp add --transport http actionlake https://connect.actionlake.com/mcpdo { action: "vtex.orders.list", intent: "check which VTEX account is connected"}# List orders · read · 1 upstream call- 932actionsin one signed file
- 423readlook, never change
- 375writecreate and update
- 134wait for a yesdestructive, confirmed first
Set up
Connect VTEX in three steps.
- 01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp - 02
Connect VTEX.
Header credentials. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
app_keyVTEX application key (Admin > Account settings > Account > Security > Application keys, or License Manager >…app_tokenThe application token shown once when the key was generatedaccountYour VTEX account
account { op: "connections.requirements", service: "vtex" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates the call and prices it, for free.do { action: "vtex.orders.list" }# list orders · read · 1 upstream callcheck { action: "vtex.catalog_product.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent
VTEX at a glance
- Sign-in
- Header credentials. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
- You provide
app_keyapp_token- Setup fields
account- Limits we pace to
- 20 calls a second, per connection
- API covered
- VTEX OpenAPI documents (vtex/openapi-schemas, master): Audience API, Authenticator API, B2B Addresses API, B2B Buyer Data API, B2B Contracts API, Budgets API, Bulk Pricing API, Buyer Organizations, Buying Policies API, Card Token Vault API, Catalog API Seller Portal, Catalog API, Checkout API, Checkout Custom Card Payment API, Custom Fields API, Customer Credit API, Data Subject Rights, Default Values API, Delivery Promise Notification API, Delivery Promise Suggestions API, GiftCard Hub API, Giftcard API, Headless CMS API, Intelligent Search API - v1, Intelligent Search API, Intelligent Search Events API - Headless, Legacy CMS Portal API, License Manager API, Logistics API, Marketplace APIs - Sent Offers, Marketplace APIs - Suggestions, Marketplace APIs, Marketplace Protocol - External Marketplace Mapper, Marketplace Protocol - External Marketplace Orders, Master Data API - v2, MasterData API - v10.2, Message Center API, Operational Capacity API, Orders API PII version, Orders API, Organization Units API, Payment Policies API, Payments Gateway API, Pick and Pack Order Changes API, Policies System API, Pricing API, Pricing Hub, Profile System, Promotions & Taxes API - v2, Promotions & Taxes API, Punchout API, Recommendations BFF API, Reviews and Ratings API, SKU Bindings API, SSL Certificates API, Search API, Session Manager API, Shopee Integration API, Storefront Roles API, Subscriptions API v3, User Rights API, VTEX Do API, VTEX ID API, VTEX Shipping Network API, mTLS API, at your own myvtex.com address, set when you connect
- Built from
- VTEX's documentation, read 23 October 2026OpenAPI spec (GitHub)OpenAPI spec (GitHub)OpenAPI spec (GitHub)
- Service file
- Version 1.0.0, signed (Ed25519)
- Cached reads
- 388 of 423 reads, for up to 5 minutes; a write clears what it affects
- Shared entities
- 2, so ask can line VTEX up with your other systems
- Data
- Processed and stored in Sydney, Australia. No US region yet
Capabilities
What an AI agent can do in VTEX.
932 actions in 533 areas. Every one carries its effect, so a key can allow the reads and hold the rest.
- 423readlook, never change
- 375writecreate and update
- 134destructivewait for a confirmation
Catalog stockkeepingunit attribute
62 read · 2 write · 2 destructive
Create SKU attribute · Get all SKU attributes · Get SKU attribute by ID · Update SKU attribute
Channel manager connector
61 read · 4 write · 1 destructive
Register connector · Upsert merchant connection · Retrieve connector · Partial update connector
Dataentity documents
61 read · 4 write · 1 destructive
Create new document · Get document · Create partial document · Create document with custom ID or update entire document
Budget allocations
52 read · 2 write · 1 destructive
Create allocation · List budget allocations · Get allocation · Update allocation
Budgets
52 read · 2 write · 1 destructive
Create budget · List budgets · Get budget · Update budget
Catalog assortment
52 read · 2 write · 1 destructive
Create product assortment · Get all product assortments · Get product assortment by ID · Update product assortment
Catalog stockkeepingunit file
51 read · 2 write · 2 destructive
Create SKU file · Get SKU files · Update SKU file · Delete all SKU files
Catalog stockkeepingunit specification
51 read · 2 write · 2 destructive
Associate SKU specification · Get SKU specifications · Update SKU specification · Delete all SKU specifications
112 more areas · 889 actions
- Catalog stockkeepingunitkit 5
- Creditcontrol accounts 5
- License manager storefront role 5
- Logistics shipping policies 5
- Organization units 5
- Organization units scopes 5
- Payment configuration service policy rules 5
- Pricing price fixed 5
- Rules 5
- Seller register seller leads 5
- Sent offers feeds 5
- Storage profile system profile addresses 5
- Storage profile system prospects 5
- Affiliations 4
- Authorization dimension rules 4
- Authorization dimensions 4
- Budget allocation reservations 4
- Catalog attachment 4
- Catalog brand 4
- Catalog collection 4
- Catalog product specification 4
- Catalog seller portal brands 4
- Catalog seller portal products 4
- Catalog skuservice 4
- Catalog skuservicetype 4
- Catalog skuservicevalue 4
- Catalog specification nonstructured 4
- Catalog stockkeepingunit 4
- Catalog stockkeepingunit ean 4
- Catalog subcollection 4
- Creditcontrol account invoices 4
- Dataentities ad documents 4
- Dataentities CL documents 4
- Dataentities contact information documents 4
- Dataentities custom field values documents 4
- Dataentities default values documents 4
- Dataentities shopper documents 4
- Dataentity indices 4
- Dataentity schemas 4
- Do tasks 4
- Fulfillment affiliates 4
- Giftcardproviders 4
- License manager storefront user roles 4
- Logistics configuration docks 4
- Logistics configuration geoshape 4
- Logistics configuration holidays 4
- Logistics configuration pickuppoints 4
- Pickpack bin location warehouses 4
- Pricing price sheet 4
- Reviews and ratings review 4
- RNB coupon 4
- RNS subscriptions 4
- Seller register seller commissions 4
- Seller register sellers 4
- Storage profile system profile purchase info 4
- Storage profile system profiles 4
- Suggestions 4
- Vtexid organization unit settings 4
- Warehouses 4
- Authenticator tenants features 3
- Catalog category 3
- Catalog product 3
- Catalog product salespolicy 3
- Catalog product similarcategory 3
- Catalog skuattachment 3
- Catalog skucomplement 3
- Catalog skuservicetypeattachment 3
- Catalog specification 3
- Catalog specificationvalue 3
- Catalog subcollection specificationvalue 3
- Catalog supplier 3
- Catalog system seller 3
- Catalog system specification field value 3
- Checkout configuration order form 3
- Checkout order form custom data 3
- CMS 3
- Creditcontrol account transactions 3
- Dataentities custom field settings documents 3
- Dataentity document score 3
- Dataentity document versions 3
- Do notes 3
- Edge certificates 3
- Giftcard transactions 3
- Giftcardprovider giftcard transactions 3
- License manager storefront resource 3
- License manager user roles 3
- License manager users 3
- Logistics inventory reservations 3
- Order system order changes 3
- Orders feed config 3
- Orders hook config 3
- Policy engine policies 3
- Price table mapper mapping 3
- Pricing prices 3
- Reviews and ratings reviews 3
- RNB campaign configuration 3
- RNB coupon group 3
- RNS subscription items 3
- Sessions 3
- VLM appkeys 3
- Vtexid organization unit users 3
- B2B import buyer orgs 2
- Budget allocation transactions 2
- Card token vault tokens 2
- Catalog assortment excluded collections 2
- Catalog assortment included collections 2
- Catalog attachment language 2
- Catalog brand language 2
- Catalog category language 2
- Catalog collection language 2
- Catalog product language 2
- 414 smaller areas 494
Top actions
The VTEX API, shaped for agents.
The ids your agent types, what each does, and the one name it shares with other systems. 24 of VTEX's 24 action names are shared with at least one other connector, so an agent learns them once.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
vtex.orders.listList orders | List orders. | read | commerce.order.list82 connectors |
vtex.warehouses.listList all warehouses | List all warehouses. | read | commerce.warehouse.list32 connectors |
vtex.orders.getGet order | Get order. | read | commerce.order.get87 connectors |
vtex.catalog_product.createCreate product with category and brand | Create product with category and brand. | write | commerce.product.create92 connectors |
vtex.warehouses.getList warehouse by ID | List warehouse by ID. | read | commerce.warehouse.get22 connectors |
vtex.license_manager_users.createCreate admin user | Create admin user. | write | identity.user.create262 connectors |
vtex.catalog_product.getGet product by ID | Get product by ID. | read | commerce.product.get112 connectors |
vtex.warehouses.deleteRemove warehouse | Remove warehouse. | destructive | commerce.warehouse.delete16 connectors |
vtex.license_manager_users.getGet admin user information by user ID | Get admin user information by user ID. | read | identity.user.get399 connectors |
vtex.catalog_category.createCreate category | Create category. | write | commerce.product_category.create19 connectors |
vtex.catalog_stockkeepingunit.createCreate SKU | Create SKU. | write | commerce.product_variant.create18 connectors |
vtex.catalog_stockkeepingunit.updateUpdate SKU | Update SKU. | write | commerce.product_variant.update18 connectors |
Try it
Prompts to paste into Claude.
Each one names the VTEX actions it will call, so you know what it reads and what it changes before you send it.
- Readread
Which VTEX orders from the last seven days are still unfulfilled?
calls
vtex.orders.list - Writewrite
Create product with category and brand in VTEX. Show me exactly what you will send before you save it.
calls
vtex.catalog_product.create
Governance for VTEX
Destructive actions wait for a yes.
134 VTEX actions are destructive. The first 10:
- Remove warehouse
vtex.warehouses.delete - Cancel order
vtex.oms_order_cancel.run - Delete admin user
vtex.license_manager_users.delete - Delete brand
vtex.catalog_brand.delete - Start a new transaction
vtex.transactions.create - Create a gift card transaction
vtex.giftcard_transactions.create - Send payments information
vtex.payments_transaction_payments.create - Refund the transaction
vtex.transaction_refunding_request.create - Create transaction
vtex.budget_allocation_transactions.create - Settle the transaction
vtex.transaction_settlement_request.create
A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.
Remove warehouse?
intent: the user asked me to remove warehouse
account { op: "keys.create", name: "vtex-agent", allowed_actions: ["vtex.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "vtex.warehouses.delete", approver: "[email protected]" }, { match: "vtex.oms_order_cancel.run", approver: "[email protected]" }, { match: "vtex.license_manager_users.delete", approver: "[email protected]" } ]}Cost
What VTEX costs on actionlake.
Every VTEX action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call VTEX refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
- 1upstream call per actionall 932 VTEX actions
- 932actions pageeach page of a long list is one call
- 388reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every VTEX action.
932 actions by area: the id your agent calls, what it does, and its effect.
Catalog stockkeepingunit attribute6
vtex.catalog_stockkeepingunit_attribute.createCreate SKU attributewritevtex.catalog_stockkeepingunit_attribute.getGet SKU attribute by IDread- and 4 more in this area
Channel manager connector6
vtex.channel_manager_connector.createRegister connectorwritevtex.channel_manager_connector.getRetrieve connectorread- and 4 more in this area
Dataentity documents6
vtex.dataentity_documents.createCreate new documentwritevtex.dataentity_documents.getGet documentread- and 4 more in this area
Budget allocations5
vtex.budget_allocations.createCreate allocationwritevtex.budget_allocations.getGet allocationread- and 3 more in this area
Budgets5
vtex.budgets.createCreate budgetwritevtex.budgets.getList budgetsread- and 3 more in this area
Catalog assortment5
vtex.catalog_assortment.createCreate product assortmentwritevtex.catalog_assortment.getGet all product assortmentsread- and 3 more in this area
Catalog stockkeepingunit file5
vtex.catalog_stockkeepingunit_file.createCreate SKU filewritevtex.catalog_stockkeepingunit_file.deleteDelete all SKU filesdestructive- and 3 more in this area
Catalog stockkeepingunit specification5
vtex.catalog_stockkeepingunit_specification.createAssociate SKU specificationwritevtex.catalog_stockkeepingunit_specification.deleteDelete all SKU specificationsdestructive- and 3 more in this area
Catalog stockkeepingunitkit5
vtex.catalog_stockkeepingunitkit.createCreate SKU kitwritevtex.catalog_stockkeepingunitkit.deleteDelete SKU kit by SKU ID or parent SKU IDdestructive- and 3 more in this area
Creditcontrol accounts5
vtex.creditcontrol_accounts.createOpen an accountwritevtex.creditcontrol_accounts.getRetrieve an account by IDread- and 3 more in this area
License manager storefront role5
vtex.license_manager_storefront_role.createCreate storefront rolewritevtex.license_manager_storefront_role.getFetch storefront role by IDread- and 3 more in this area
Logistics shipping policies5
vtex.logistics_shipping_policies.createCreate shipping policywritevtex.logistics_shipping_policies.getRetrieve shipping policy by IDread- and 3 more in this area
Organization units5
vtex.organization_units.createCreate organization unitwritevtex.organization_units.getGet organization unitread- and 3 more in this area
Organization units scopes5
vtex.organization_units_scopes.createCreate organization unit scopewritevtex.organization_units_scopes.deleteDelete all scopes from organization unitdestructive- and 3 more in this area
Payment configuration service policy rules5
vtex.payment_configuration_service_policy_rules.createCreate policy rulewritevtex.payment_configuration_service_policy_rules.getGet policy rule by IDread- and 3 more in this area
Pricing price fixed5
vtex.pricing_price_fixed.createCreate or update fixed prices on a price table or trade policywritevtex.pricing_price_fixed.getGet fixed prices on a price table or trade policyread- and 3 more in this area
Rules5
vtex.rules.createInsert a new payment rulewritevtex.rules.getGet payment rule by IDread- and 3 more in this area
Seller register seller leads5
vtex.seller_register_seller_leads.createInvite seller leadwritevtex.seller_register_seller_leads.getList seller leadsread- and 3 more in this area
Sent offers feeds5
vtex.sent_offers_feeds.createActivate Feedwritevtex.sent_offers_feeds.getGet Feed by feedIdread- and 3 more in this area
Storage profile system profile addresses5
vtex.storage_profile_system_profile_addresses.createCreate client addresswritevtex.storage_profile_system_profile_addresses.getGet addressread- and 3 more in this area
Storage profile system prospects5
vtex.storage_profile_system_prospects.createCreate prospectwritevtex.storage_profile_system_prospects.getGet prospectread- and 3 more in this area
Affiliations4
vtex.affiliations.createInsert new affiliationwritevtex.affiliations.getGet affiliation by IDread- and 2 more in this area
Authorization dimension rules4
vtex.authorization_dimension_rules.createCreate dimension rulewritevtex.authorization_dimension_rules.deleteDelete dimension ruledestructive- and 2 more in this area
Authorization dimensions4
vtex.authorization_dimensions.createCreate dimensionwritevtex.authorization_dimensions.deleteDelete dimensiondestructive- and 2 more in this area
Budget allocation reservations4
vtex.budget_allocation_reservations.createCreate reservationwritevtex.budget_allocation_reservations.deleteDelete reservationdestructive- and 2 more in this area
Catalog attachment4
vtex.catalog_attachment.createCreate attachmentwritevtex.catalog_attachment.deleteDelete attachmentdestructive- and 2 more in this area
Catalog brand4
vtex.catalog_brand.createCreate brandwritevtex.catalog_brand.deleteDelete branddestructive- and 2 more in this area
Catalog collection4
vtex.catalog_collection.createCreate collectionwritevtex.catalog_collection.deleteDelete collectiondestructive- and 2 more in this area
Catalog product specification4
vtex.catalog_product_specification.createAssociate product specificationwritevtex.catalog_product_specification.deleteDelete all product specifications by product IDdestructive- and 2 more in this area
Catalog seller portal brands4
vtex.catalog_seller_portal_brands.createCreate brandwritevtex.catalog_seller_portal_brands.getGet brand by IDread- and 2 more in this area
Catalog seller portal products 4Catalog skuservice 4Catalog skuservicetype 4Catalog skuservicevalue 4Catalog specification nonstructured 4Catalog stockkeepingunit 4Catalog stockkeepingunit ean 4Catalog subcollection 4Creditcontrol account invoices 4Dataentities ad documents 4Dataentities CL documents 4Dataentities contact information documents 4Dataentities custom field values documents 4Dataentities default values documents 4Dataentities shopper documents 4Dataentity indices 4Dataentity schemas 4Do tasks 4Fulfillment affiliates 4Giftcardproviders 4License manager storefront user roles 4Logistics configuration docks 4Logistics configuration geoshape 4Logistics configuration holidays 4Logistics configuration pickuppoints 4Pickpack bin location warehouses 4Pricing price sheet 4Reviews and ratings review 4RNB coupon 4RNS subscriptions 4Seller register seller commissions 4Seller register sellers 4Storage profile system profile purchase info 4Storage profile system profiles 4Suggestions 4Vtexid organization unit settings 4Warehouses 4Authenticator tenants features 3Catalog category 3Catalog product 3Catalog product salespolicy 3Catalog product similarcategory 3Catalog skuattachment 3Catalog skucomplement 3Catalog skuservicetypeattachment 3Catalog specification 3Catalog specificationvalue 3Catalog subcollection specificationvalue 3Catalog supplier 3Catalog system seller 3Catalog system specification field value 3Checkout configuration order form 3Checkout order form custom data 3CMS 3Creditcontrol account transactions 3Dataentities custom field settings documents 3Dataentity document score 3Dataentity document versions 3Do notes 3Edge certificates 3Giftcard transactions 3Giftcardprovider giftcard transactions 3License manager storefront resource 3License manager user roles 3License manager users 3Logistics inventory reservations 3Order system order changes 3Orders feed config 3Orders hook config 3Policy engine policies 3Price table mapper mapping 3Pricing prices 3Reviews and ratings reviews 3RNB campaign configuration 3RNB coupon group 3RNS subscription items 3Sessions 3VLM appkeys 3Vtexid organization unit users 3B2B import buyer orgs 2Budget allocation transactions 2Card token vault tokens 2Catalog assortment excluded collections 2Catalog assortment included collections 2Catalog attachment language 2Catalog brand language 2Catalog category language 2Catalog collection language 2Catalog product language 2414 smaller areas 494
This index shows a sample of each area. All 932 actions, with their inputs and prices, are in the catalogue, which a free sandbox key can search.
Questions
The VTEX MCP server, answered.
Is there a VTEX MCP server for Claude?
Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 932 VTEX actions across catalog stockkeepingunit attribute, channel manager connector, dataentity documents and budget allocations, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by VTEX.
What do I need to connect VTEX?
VTEX application key (Admin > Account settings > Account > Security > Application keys, or License Manager >… and The application token shown once when the key was generated. Plus your account. The free call account { op: "connections.requirements", service: "vtex" } lists exactly what to paste.
Can an AI agent delete or change things in VTEX?
Only if its key allows it, and only with an explicit confirmation. 134 VTEX actions are destructive, including remove warehouse, cancel order and delete admin user. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.
Will an AI agent use up my VTEX API limit?
actionlake paces every call to the limits in the VTEX service file: 20 calls a second per connection. Repeated reads are answered from cache (388 VTEX actions can be), which never reaches VTEX.
What does a VTEX action cost?
One upstream call, the only unit actionlake bills. A list that pages bills one call per page (932 VTEX actions page). Cache hits, searches, dry runs and calls VTEX refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
Which VTEX API does it cover?
The VTEX OpenAPI documents (vtex/openapi-schemas, master): Audience API, Authenticator API, B2B Addresses API, B2B Buyer Data API, B2B Contracts API, Budgets API, Bulk Pricing API, Buyer Organizations, Buying Policies API, Card Token Vault API, Catalog API Seller Portal, Catalog API, Checkout API, Checkout Custom Card Payment API, Custom Fields API, Customer Credit API, Data Subject Rights, Default Values API, Delivery Promise Notification API, Delivery Promise Suggestions API, GiftCard Hub API, Giftcard API, Headless CMS API, Intelligent Search API - v1, Intelligent Search API, Intelligent Search Events API - Headless, Legacy CMS Portal API, License Manager API, Logistics API, Marketplace APIs - Sent Offers, Marketplace APIs - Suggestions, Marketplace APIs, Marketplace Protocol - External Marketplace Mapper, Marketplace Protocol - External Marketplace Orders, Master Data API - v2, MasterData API - v10.2, Message Center API, Operational Capacity API, Orders API PII version, Orders API, Organization Units API, Payment Policies API, Payments Gateway API, Pick and Pack Order Changes API, Policies System API, Pricing API, Pricing Hub, Profile System, Promotions & Taxes API - v2, Promotions & Taxes API, Punchout API, Recommendations BFF API, Reviews and Ratings API, SKU Bindings API, SSL Certificates API, Search API, Session Manager API, Shopee Integration API, Storefront Roles API, Subscriptions API v3, User Rights API, VTEX Do API, VTEX ID API, VTEX Shipping Network API, mTLS API at your own myvtex.com address, set when you connect. It is built from VTEX's documentation as read on 23 October 2026. 932 actions in 533 areas, each one in the signed service file (version 1.0.0).
Does actionlake keep my VTEX data, and where?
actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your VTEX credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.
Which AI clients can use it?
Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.
Give your agent VTEX today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.