# Cupom Center

> Cupom Center is a freemium MCP server for e-commerce. Local MCP server that helps AI agents integrate with the Cupom Center coupon API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, self-hosted
- **Website:** https://cupom.center
- **Repository:** https://github.com/experiens/cupom-center-mcp
- **MCP Registry name:** io.github.experiens/cupom-center
- **Categories:** e-commerce
- **Listing updated:** 2026-11-15

## About

Cupom Center is a Brazilian B2B platform for coupons, free shipping and promotions, with rules, budgets and audit trails configured in a dashboard and queried by shops and apps through an API. This MCP server is a local helper for developers wiring a client system to that API. It runs over stdio on your machine, opens no network port and hosts no model.

Beyond mirroring the REST endpoints as tools, it teaches the agent the correct sequence: find eligible coupons without reserving anything, calculate the discount and reserve a temporary quote, confirm the redemption with the same context, record payment only after external confirmation, then reconcile or reverse. A recommend_integration_flow tool picks the flow without calling the API or using the organisation's quota.

A project and environment API key is required, and organisation, environment and project are always derived from it, so a tool argument cannot switch tenant. Permissions such as read, issue, redeem and payment write gate each group of tools. Commercial calls are never retried automatically, and issuance uses an idempotency key. The package is @cupom_center/mcp on npm and needs Node.js 20 or later.

## Features

- **Eligibility discovery:** Finds coupons a cart qualifies for without reserving or consuming them.
- **Quote then redeem:** Calculates a discount, reserves a temporary quote and confirms redemption with the same context.
- **Individual code issuance:** Creates, reads and revokes single-use codes, for example for abandoned carts.
- **Payment and reversal:** Records payment after external confirmation and reverses uses and budgets.
- **Flow recommendation:** recommend_integration_flow chooses the right sequence without using quota.
- **Tenant-safe keys:** Organisation, environment and project come from the API key and cannot be overridden.

## Good for

- Have an assistant build a coupon checkout integration
- Check which coupons a given cart can use
- Issue a one-off code for an abandoned cart
- Reverse a redemption and its budget use after a cancelled order
- Reconcile coupon operations against payments

## Install

### Claude Code (Terminal)

```sh
claude mcp add cupom-center --env CUPOM_API_KEY='<CUPOM_API_KEY>' -- npx -y @cupom_center/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cupom-center": {
      "command": "npx",
      "args": [
        "-y",
        "@cupom_center/mcp"
      ],
      "env": {
        "CUPOM_API_KEY": "<CUPOM_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cupom-center": {
      "command": "npx",
      "args": [
        "-y",
        "@cupom_center/mcp"
      ],
      "env": {
        "CUPOM_API_KEY": "<CUPOM_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cupom-center": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cupom_center/mcp"
      ],
      "env": {
        "CUPOM_API_KEY": "<CUPOM_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cupom-center": {
      "command": "npx",
      "args": [
        "-y",
        "@cupom_center/mcp"
      ],
      "env": {
        "CUPOM_API_KEY": "<CUPOM_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cupom-center": {
      "command": "npx",
      "args": [
        "-y",
        "@cupom_center/mcp"
      ],
      "env": {
        "CUPOM_API_KEY": "<CUPOM_API_KEY>"
      }
    }
  }
}
```

## Tools

- `recommend_integration_flow`: Decides the integration flow without calling the API.
- `find_eligible_coupons`: Finds eligible coupons without reserving or consuming them.
- `quote_single_coupon`: Calculates a discount and reserves a temporary quote for one coupon.
- `quote_multiple_coupons`: Quotes several coupons together.
- `select_coupons_for_units`: Selects coupons for individual units.
- `create_coupon_issuance`: Issues an individual coupon code.
- `get_coupon_issuance`: Reads an issued code.
- `revoke_coupon_issuance`: Revokes an issued code.
- `redeem_single_coupon`: Confirms redemption of one coupon.
- `redeem_multiple_coupons`: Confirms redemption of several coupons.
- `get_coupon_operation`: Reads an operation for reconciliation.
- `record_operation_payment`: Records payment after external confirmation.
- `reverse_operation`: Reverses uses and budgets.

## FAQ

### What do I need to run it?

Node.js 20 or later and an API key for the correct project and environment, set as CUPOM_API_KEY.

### Does it open a network port?

No. It runs locally over stdio and calls api.cupom.center with your key.

### Are requests retried automatically?

Not for calls with commercial effect. After a timeout you should check state rather than retry blindly.

### Can I use it without an API key?

It starts without one for the guide and recommend_integration_flow, but REST-backed tools return a configuration error until the key is set.

### Is Cupom Center free?

Cupom Center has a free plan, with paid plans for more usage or features.

### How do I add Cupom Center to Claude Code?

Run this command in your terminal: claude mcp add cupom-center --env CUPOM_API_KEY='<CUPOM_API_KEY>' -- npx -y @cupom_center/mcp

### What are the best alternatives to Cupom Center?

The closest alternatives to Cupom Center are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/cupom-center
