Discount Engine
Create and manage discount codes. Types: percentage (15 = 15% off), fixed_amount (1000 = €10.00 off, in cents), free_shipping. Validates expiry, max uses, and minimum order amount. Codes are case-insensitive (stored uppercase).
Endpoints (7)
Create a new discount code. Codes are case-insensitive (stored uppercase). Unique per project.
No input parameters required.
Check if a discount code is valid. Validates: exists, active, within date range, not maxed out, minimum order met. Returns valid=true/false with reason.
No input parameters required.
Calculate the discount amount for a given code and subtotal. Returns discount_cents. Percentage: subtotal × value/100. Fixed: min(value, subtotal). Free shipping: returns 0 (caller sets shipping to 0).
No input parameters required.
Increment the used_count of a discount code by 1. Call this after a successful payment to track usage.
No input parameters required.
List all discount codes for this project. Optionally filter by status or type.
No input parameters required.
Update an existing discount code. Only send fields you want to change.
No input parameters required.
Delete a discount code permanently.
No input parameters required.
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| create-discount | discount-engine_create_discount |
| validate-code | discount-engine_validate_code |
| calculate-discount | discount-engine_calculate_discount |
| increment-usage | discount-engine_increment_usage |
| list-discounts | discount-engine_list_discounts |
| update-discount | discount-engine_update_discount |
| delete-discount | discount-engine_delete_discount |