Create and check discount codes
One company's docs show a full fit.
What counts as done
The code created with the stated rules and verified by applying it to a test cart, or a rejected code explained with a machine-readable reason.
Measured, for our own tests: done in at most 3 calls. No docs we read state these figures, so they don't count against a listing here.
How agents ask for it: make a 10% code for this customer list
, extend this code until Friday
, why didn't this coupon apply
, how much store credit is left
Does the job 1
The docs show it meets the test above, and nothing we read says otherwise.
| Listing | Why |
|---|---|
| Spree Commerce BB Vendo Connect Inc | Cart discount_codes returns machine-readable errors such as coupon_code_not_eligible, but creating a promotion with its rules through create_resource may take more than one call. source |
Does the job, with a limit 17
It does the job, but something in the docs or a user's account will get in an agent's way. The limit is named in each row.
| Listing | Why |
|---|---|
| Adobe Commerce (Magento) D Adobe Inc. | applyCouponToCart applies a code to a test cart and returns an error message, but no machine-readable code list for coupon rejection appears on the page. source |
| BigCommerce API + MCP B Commerce.com US, Inc. | create_promotion makes one rule, created disabled, and get_promotions finds a code's promotion, but no MCP tool applies a code to a test cart or returns a rejection reason; create is not safe to retry. source |
| Commerce Layer API + MCP B Commerce Layer, Inc. | Promotions, coupons and external promotions exist in the Core API, but no machine-readable coupon rejection reason was read. source |
| commercetools BB commercetools GmbH | create_discount_codes and create_cart_discounts exist and update_carts can add a code to a test cart, but the rejection-state field was not read this run. source |
| Ecwid by Lightspeed C Ecwid, Inc. | Discount coupons and promotions have create, update and search endpoints, but with no server-side cart there is no way to test a code or read a rejection reason. source |
| Elastic Path API + MCP C Elastic Path Software Inc. | Promotions, promotion codes and cart promotion endpoints exist, but no machine-readable rejection reason was read. source |
| Fabric E Commerce Fabric, Inc. | Promotions, coupons and coupon-codes APIs create and manage codes, but applying one to a test cart and reading a rejection reason was not read. source |
| Medusa API + MCP C MedusaJS, Inc. | Store routes add promotions to a cart, but no machine-readable rejection reasons were found in the reference, and the MCP can only read promotions. source |
| Saleor API + MCP BB Saleor Commerce sp. z o.o. | CheckoutErrorCode gives VOUCHER_NOT_APPLICABLE, but promotion and voucher settings are high-impact and checkouts are excluded from the MCP, so a test-cart check needs the API directly. source |
| Shopify API + MCP BB Shopify Inc. | Discount codes are created over the Admin API, but accounts report combination and once-per-customer rules not enforced after checkout and no webhook when a discount expires. source |
| Shopware BB shopware AG | Promotions are entities the upsert tool can write with a dry run, but no promotion tool or cart test path exists in the MCP, and rejection reasons were not read. source |
| Snipcart API + MCP D Snipcart inc. | create_discount takes code, cart-total or product triggers and amounts, but with no server-side cart a code cannot be tested and no rejection reason is returned. source |
| Square B Block, Inc. | Discounts and pricing rules are catalogue objects, gift cards and loyalty are services, but no discount-code object or rejection reason was found in what was read. source |
| Swell C Swell Commerce Corp. | create_coupon and create_promotion take the rules but create them inactive; only a person can activate them in the dashboard, so the agent cannot test a code on a cart. source |
| Vendure BB Elevantiq GmbH | apply_coupon_code tests a code on a cart, but no admin tool creates promotions, and the docs note a valid coupon may sit in couponCodes without changing the total. source |
| Wix Stores and eCommerce API B Wix.com Ltd. | Cart V2 add-coupon returns machine-readable codes such as INVALID_COUPON_CODE, INVALID_COUPON_STATUS and MAX_COUPONS_PER_CART_EXCEEDED; the Coupons create page was listed but not read. source |
| WooCommerce API + MCP BB WooCommerce, Inc. | REST coupons exist and Store API cart/coupons returns an error when a code doesn't apply, but no coupon ability exists in the MCP, so an agent there refuses. source |
What stops agents finishing
- no discount tools in the agent interface
- combination rules not enforced outside checkout
- no event when a discount expires
Around it
Before: crm.customer-list, chat.user-request. After: email.send, commerce.cart-to-checkout.
Where this comes from
Weight 5 of 100 in Commerce & checkout: 3 of 49 accounts (WooCommerce coupon abilities, two Shopify forum threads); one of the four buyer checks, so kept
The same as data: /api/v1/use-cases/commerce.manage-discounts.json, or the MCP tool get_use_case with id commerce.manage-discounts. Other jobs in this category: /api/v1/niches?category=commerce.
For companies
Do agents find, use and choose your tools?
An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.