# Cupom Center (npm · @cupom_center/mcp)

Conecta agentes de IA à API REST do Cupom Center com fluxos seguros de cupons.

- Trust score: 70/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- npm · `@cupom_center/mcp`: 70/100 (this document), [markdown](https://verifymcp.io/servers/experiens-cupom-center/cupom-center-mcp.md), [page](https://verifymcp.io/servers/experiens-cupom-center/cupom-center-mcp)

## Channel facts

- Registry: `npm`
- Package: `@cupom_center/mcp`
- Version: `0.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 0 of 3 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 79/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1502 tokens (~107/item across 14 items; 13 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 3/100
  - Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 74/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 23% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 15 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Cupom Center MCP server?

Cupom Center runs locally as an npm package, launched with npx -y @cupom_center/mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add experiens-cupom-center -- npx -y @cupom_center/mcp
```

### Cursor

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

### VS Code

```json
{
  "servers": {
    "experiens-cupom-center": {
      "command": "npx",
      "args": [
        "-y",
        "@cupom_center/mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add experiens-cupom-center -- npx -y @cupom_center/mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "experiens-cupom-center": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@cupom_center/mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add experiens-cupom-center --command npx --arg -y --arg @cupom_center/mcp
```

### Hermes

```yaml
mcp_servers:
  experiens-cupom-center:
    command: "npx"
    args: ["-y", "@cupom_center/mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "experiens-cupom-center": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@cupom_center/mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add experiens-cupom-center -t stdio -c npx -a -y @cupom_center/mcp
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 0 to 3. That category is still filling its 30-day observation window: 0 days of observed history at the previous scan, 1 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-04 (score 69)

First indexed and scored.

## MCP tools (13)

### `recommend_integration_flow` (~91 tokens)

Recommend Cupom Center integration flow

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.

Input parameters:

- `business_goal` (string, required)
- `operation_id_known` (boolean)
- `payment_confirmed` (boolean)

### `find_eligible_coupons` (~68 tokens)

Find eligible coupons

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.

Input parameters:

- `context` (object)
- `pagination` (object)

### `quote_single_coupon` (~78 tokens)

Calculate and reserve one coupon

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.

Input parameters:

- `cart_id` (string)
- `context` (object, required)
- `coupon_code` (string, required): Coupon code supplied or selected for the customer.

### `quote_multiple_coupons` (~83 tokens)

Calculate and reserve multiple coupons

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.

Input parameters:

- `cart_id` (string)
- `context` (object, required)
- `coupon_codes` (array, required)
- `selection` (object, required)

### `select_coupons_for_units` (~99 tokens)

Select coupons per unit

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.

Input parameters:

- `context` (object)
- `max_coupons_per_unit` (integer)
- `mode` (string, required)
- `priority` (string)
- `units` (array, required)

### `create_coupon_issuance` (~153 tokens)

Issue an individual coupon code

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.

Input parameters:

- `cart` (array, required)
- `coupon_id` (string, required): Existing Cupom Center coupon configured with ISSUED distribution.
- `external_reference` (string, required): Stable reference for the CRM, recovery, or distribution event.
- `idempotency_key` (string, required): Stable per-attempt key. Reuse it unchanged after a timeout.
- `metadata`
- `shipping` (object)
- `subject` (object, required)
- `valid_until` (string)

### `get_coupon_issuance` (~44 tokens)

Get coupon issuance

Read the current state and immutable commercial details of an individual issued code.

Input parameters:

- `issuance_id` (string, required): Issuance ID returned by create_coupon_issuance.

### `revoke_coupon_issuance` (~64 tokens)

Revoke coupon issuance

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.

Input parameters:

- `issuance_id` (string, required): Issuance ID returned by create_coupon_issuance.

### `redeem_single_coupon` (~113 tokens)

Redeem one coupon

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.

Input parameters:

- `cart_id` (string)
- `context` (object, required)
- `coupon_code` (string, required): Coupon code supplied or selected for the customer.
- `order_id` (string)
- `payment` (object)
- `quote_id` (string)

### `redeem_multiple_coupons` (~98 tokens)

Redeem multiple coupons

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.

Input parameters:

- `cart_id` (string)
- `context` (object, required)
- `coupon_codes` (array, required)
- `order_id` (string)
- `payment` (object)
- `quote_id` (string)
- `selection` (object, required)

### `get_coupon_operation` (~57 tokens)

Get coupon operation

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.

Input parameters:

- `operation_id` (string, required): operation_id returned by a successful redeem.

### `record_operation_payment` (~62 tokens)

Record confirmed operation payment

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.

Input parameters:

- `operation_id` (string, required): operation_id returned by a successful redeem.
- `payment` (object, required)

### `reverse_operation` (~68 tokens)

Cancel or refund a coupon operation

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.

Input parameters:

- `operation_id` (string, required): operation_id returned by a successful redeem.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/experiens-cupom-center/cupom-center-mcp#diagnostics

## Score history

- 2026-11-05: 70
- 2026-11-04: 69

## Common questions

### What is the Cupom Center MCP server?

Cupom Center is an MCP server listed in the public MCP registry as io.github.experiens/cupom-center. Conecta agentes de IA à API REST do Cupom Center com fluxos seguros de cupons. This page covers its npm package (@cupom_center/mcp).

### Is the Cupom Center MCP server safe to use?

Cupom Center scores 70 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Cupom Center MCP server expose?

Cupom Center exposes 13 tools: recommend_integration_flow, find_eligible_coupons, quote_single_coupon, quote_multiple_coupons, select_coupons_for_units, and 8 more. Their descriptions and schemas cost roughly 1,078 tokens of context every time the server is loaded.

### Is the Cupom Center MCP server still maintained?

Cupom Center is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Cupom Center MCP server under?

Cupom Center declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the Cupom Center MCP server?

VerifyMCP ran 16 checks on Cupom Center, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/@cupom_center/mcp
- Socket report: https://socket.dev/npm/package/@cupom_center/mcp
- Repository: https://github.com/experiens/cupom-center-mcp
- Website: https://cupom.center/
- Changelog RSS feed: https://verifymcp.io/servers/experiens-cupom-center/cupom-center-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/experiens-cupom-center/cupom-center-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/experiens-cupom-center/cupom-center-mcp.json
- HTML version of this page: https://verifymcp.io/servers/experiens-cupom-center/cupom-center-mcp