Skip to content
MCP server

Cupom Center

Local MCP server that helps AI agents integrate with the Cupom Center coupon API

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Cupom Center

Cupom Center is a freemium MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • CUPOM_API_KEYAPI key do projeto e ambiente no Cupom Center.Required

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

The Cupom Center site says to start free and upgrade as you grow; plan prices not published

Prices change. Check cupom.center before you buy.

Cupom Center 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 to Cupom Center

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data