VTEX Promotions & Taxes MCP connector
VTEX Promotions & Taxes is VTEX's API for managing promotional campaigns, coupon programs, and tax configurations within the VTEX commerce platform. The VTEX Promotions & Taxes MCP connector allows AI agents to create and update promotions, archive and retrieve coupons by code, and configure tax rules and discount policies. It also supports managing campaign audiences, listing archived promotions and taxes, and monitoring usage notifications across your VTEX 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 manage promotional campaigns with custom discount rules and coupon codes
- Configure tax settings and rates across different trade policies and regions
- Generate bulk coupons for large-scale promotional campaigns in VTEX
- Track coupon usage and redemption metrics to measure promotion performance
- Archive and unarchive promotions and taxes to maintain clean, organized catalogs
- Calculate final prices by applying discounts, taxes, and bundle rules automatically
- Define campaign audiences and segment customers for targeted promotional offers
Example prompts
Use the following example prompts to invoke VTEX Promotions & Taxes MCP connector tools from your AI assistant or Boomi Connect workflow:
Show me all active promotions in VTEX Promotions & Taxes.Create a new coupon code for a 20% discount on winter items.Generate 1,000 bulk coupons for our holiday campaign in VTEX.What is the redemption rate for coupon code SUMMER2024 in VTEX Promotions & Taxes?Archive the expired summer promotion in VTEX.Set up a tax configuration for our new region in VTEX Promotions & Taxes.Calculate the final price for a bundle order with discounts and taxes applied.List all campaign audiences we've created in VTEX Promotions & Taxes.Update the discount percentage for our loyalty program coupon in VTEX.Unarchive the Valentine's Day promotion from VTEX Promotions & Taxes.
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 | Sends notifications about promotion and tax tool usage and activity. |
| GetArchivedPromotions | Retrieves a list of all promotions that have been archived. |
| ArchivePromotion | Archives an existing promotion or tax to remove it from active use. |
| Getarchivedbycouponcode | Retrieves an archived coupon using its unique coupon code identifier. |
| Archivebycouponcode | Archives a coupon by its code to deactivate it from circulation. |
| GetArchivedTaxes | Retrieves a list of all taxes that have been archived. |
| GetAllBenefits | Retrieves all active promotions available in the system. |
| CreateOrUpdateCalculatorConfiguration | Creates a new promotion or tax, or updates an existing one. |
| GetCalculatorConfigurationById | Retrieves a specific promotion or tax using its unique identifier. |
| Getcampaignaudiences | Retrieves all campaign audiences configured in the system. |
| Setcampaignconfiguration | Creates a new audience segment for targeted marketing campaigns. |
| Getcampaignconfiguration | Retrieves the configuration details for a specific campaign audience. |
| Getall | Retrieves all coupons currently stored in the system. |
| Update | Updates the details and settings of an existing coupon. |
| createApiRnbPvtCoupon | Creates a single new coupon with specified properties. |
| Getusage | Retrieves usage statistics and redemption data for a coupon. |
| Getbycouponcode | Retrieves a specific coupon using its unique coupon code. |
| MassiveGeneration | Generates multiple coupons in bulk with a single operation. |
| createApiRnbPvtMultipleCoupons | Creates several new coupons at once with specified configurations. |
| GetAllTaxes | Retrieves all active taxes configured in the system. |
| UnarchivePromotion | Restores an archived promotion or tax back to active status. |
| Unarchivebycouponcode | Restores an archived coupon back to active use by code. |
| Saveprice | Saves or updates a product price in the system. |
| Getallpaged | Retrieves prices in paginated format for easier browsing. |
| Pricebycontext | Retrieves the price for a product based on contextual factors. |
| DeletebyskuId | Removes a product price record using its SKU identifier. |
| PricebyskuId | Retrieves the price for a product by its SKU number. |
| PricebyskuIdandtradePolicy | Retrieves a product price by SKU and applicable trade policy. |
| Calculatediscountsandtaxes(Bundles) | Calculates total discounts and taxes for bundled product offerings. |
