Cupom Center
Local MCP server that helps AI agents integrate with the Cupom Center coupon API
- 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/mcpAdd 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
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce

Renta
MCP serverRemote MCP server for running an outdoor rental shop on Renta from an AI client
- Remote
- Paid
- E-commerce

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce

repairinfo
MCP serverRepairability scores and spare-parts years for EU appliances and electronics
- 4 tools
- Remote
- Freemium
- Analytics and data