Cupom Center MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CUPOM_API_KEY | Yes | API key created for the correct project and environment in Cupom Center. Organization, environment, and project are derived from this key. The server can start without it for the guide and recommend_integration_flow, but REST tools will return a configuration error until it is set. | |
| CUPOM_API_URL | No | Optional Cupom Center API base URL. Defaults to https://api.cupom.center. HTTP is only accepted for localhost. | https://api.cupom.center |
| CUPOM_API_TIMEOUT_MS | No | Optional API timeout in milliseconds. Defaults to 20000 and accepts values between 1000 and 120000. | 20000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| recommend_integration_flowA | Choose the correct Cupom Center workflow before making API calls. This tool is local, has no commercial effect, and consumes no Cupom Center API allowance. Use it whenever it is unclear whether to discover, quote, issue, redeem, record payment, inspect, or reverse. |
| find_eligible_couponsA | Discover coupons whose configured rules match the known customer/cart context. This does not calculate final totals, reserve budget, or consume a coupon. Missing context intentionally excludes coupons that require that fact. public defaults to true. |
| quote_single_couponA | Validate a known coupon code against the current cart, calculate authoritative totals, and create a temporary quote reservation. Use before redeeming or displaying a final discount. Do not use for catalog discovery. |
| quote_multiple_couponsB | Validate and calculate 2–10 known coupon codes. code_order stacks sequentially in supplied order; highest_discount_per_product applies only the best coupon to each product. Every supplied code must be eligible and applied. |
| select_coupons_for_unitsA | Automatically select public coupons for 1–20 marketplace/store units. Use only when a cart is partitioned into units and the integration wants Cupom Center to choose by coverage or total discount. This is not for validating a known code. |
| create_coupon_issuanceB | Create an individual code from an existing coupon configured with ISSUED distribution, typically for cart recovery, CRM, or individualized delivery. This never creates discount rules. Requires COUPON_ISSUE and a stable idempotency key. |
| get_coupon_issuanceB | Read the current state and immutable commercial details of an individual issued code. |
| revoke_coupon_issuanceA | Revoke one active individual issuance. This is idempotent but cannot reactivate a consumed or expired code. Use only when the individual code must no longer be accepted. |
| redeem_single_couponA | Confirm one coupon as a commercial operation. Normally call after quote_single_coupon and send the same cart/context. Provide cart_id, context.user.id, or quote_id for correlation. Include payment only after external confirmation; Cupom Center does not charge money. |
| redeem_multiple_couponsA | Atomically confirm 2–10 coupons previously calculated together. Preserve code order and selection strategy from the quote. Either all applicable uses/budgets confirm or none do. |
| get_coupon_operationA | Inspect a redemption operation, immutable receipts, current payment, and reversals. Use for reconciliation and as the first recovery step after a timeout when operation_id is known. |
| record_operation_paymentA | Record an integral payment that an external payment provider has already confirmed. This does not charge or capture money and does not consume coupons again. Requires PAYMENT_WRITE. |
| reverse_operationA | Fully reverse one coupon operation and release its usage counters and budgets. The backend classifies it as cancellation without payment or refund with confirmed payment. This does not move money at the payment provider and accepts no reason or partial amount. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| cupom-center-integration-guide | Authoritative decision rules for choosing the correct coupon operation. |
TDQS
Scored across 13 tools
Most tools have clearly distinct purposes, especially with explicit 'do not use for' guidance separating discovery, quoting, selection, issuance, redemption, and operation inspection. Some boundaries between find_eligible_coupons, select_coupons_for_units, and quote_multiple_coupons require careful reading, and single/multiple quote and redeem pairs could be confused at a glance.
All tool names use snake_case with a predictable verb-first pattern, and related operations consistently use shared nouns such as coupon_issuance, coupon_operation, single_coupon, and multiple_coupons. The naming convention is stable throughout the set.
The 13 tools map cleanly onto the coupon lifecycle: guidance, discovery, quoting, selection, issuance, redemption, payment recording, inspection, and reversal. The set is large enough to cover the workflow without appearing bloated or redundant.
The core lifecycle from discovery through quoting, issuance, redemption, inspection, payment recording, and reversal is covered. Minor gaps exist, such as no list/search operations for issuances or redemption operations and no direct quote retrieval by quote_id, but these are workable around.