VTEX Promotions & Taxes MCP connector
VTEX Promotions & Taxes is VTEX's API for managing promotional campaigns, coupons, and tax configurations within an online store. The VTEX Promotions & Taxes MCP connector allows AI agents to create, update, and archive promotions and tax rules, as well as manage coupon codes and campaign audiences. It also supports retrieving active and archived promotions, taxes, and coupons, giving teams visibility into discount rules and tax settings across their tenant.
Authentication type
- API Key - Requires a static API key to be configured before the agent can connect to the service.
Uses
Use the VTEX Promotions & Taxes MCP connector to perform the following actions:
- Create and update promotions, coupons, and tax rules across VTEX stores
- Automate bulk coupon generation for marketing and loyalty campaigns
- Archive and unarchive outdated promotions, taxes, and coupons for compliance
- Track coupon usage and redemption trends in real time
- Manage SKU-level pricing and trade policy configurations
- Calculate bundled discounts and taxes before checkout
- Build targeted campaign audiences for personalized promotions
- Retrieve historical promotion and tax records for audits
Example prompts
Use the following example prompts to invoke VTEX Promotions & Taxes MCP connector tools from your AI assistant or Boomi Connect workflow:
Create a 20% discount coupon for the summer sale in VTEX Promotions & Taxes.Show me all active promotions currently running in VTEX Promotions & Taxes.Generate 500 unique coupon codes for our loyalty campaign.What is the usage count for coupon code SPRING25?Archive all expired promotions from last quarter.Update the price for SKU 12345 in VTEX Promotions & Taxes.List every tax configuration set up for our Brazil store.Calculate the total discount and tax for this product bundle.Find the coupon details for code WELCOME10.Create a new campaign audience for our VIP customers.
VTEX Promotions & Taxes MCP connector tools
The VTEX Promotions & Taxes MCP connector provides the following tools. Each tool maps to a specific action you can invoke from your AI agent or automation.
| Tool | Description |
|---|---|
| Usagenotification | Usage notification |
| GetArchivedPromotions | List Archived Promotions |
| ArchivePromotion | Archive Promotion or Tax |
| Getarchivedbycouponcode | Get archived coupon by coupon code |
| Archivebycouponcode | Archive coupon by coupon code |
| GetArchivedTaxes | List Archived Taxes |
| GetAllBenefits | Get All Promotions |
| CreateOrUpdateCalculatorConfiguration | Create or Update Promotion or Tax |
| GetCalculatorConfigurationById | Get Promotion or Tax by ID |
| Getcampaignaudiences | Get all campaign audiences |
| Setcampaignconfiguration | Create campaign audience |
| Getcampaignconfiguration | Get campaign audience configuration |
| Getall | Get all coupons |
| Update | Update coupon |
| createApiRnbPvtCoupon | Create coupon |
| Getusage | Get coupon usage |
| Getbycouponcode | Get coupon by coupon code |
| MassiveGeneration | Coupon Massive Generation |
| createApiRnbPvtMultipleCoupons | Create multiple coupons |
| GetAllTaxes | Get All Taxes |
| UnarchivePromotion | Unarchive Promotion or Tax |
| Unarchivebycouponcode | Unarchive coupon by coupon code |
| Saveprice | Save Price |
| Getallpaged | Get all paged prices |
| Pricebycontext | Get Price by context |
| DeletebyskuId | Delete Price by SKU Id |
| PricebyskuId | Get Price by SKU ID |
| PricebyskuIdandtradePolicy | Get Price by SKU ID and Trade Policy |
| Calculatediscountsandtaxes(Bundles) | Calculate discounts and taxes (Bundles) |
