Server data from the Official MCP Registry
Conecta agentes de IA à API REST do Cupom Center com fluxos seguros de cupons.
About
Conecta agentes de IA à API REST do Cupom Center com fluxos seguros de cupons.
Security Report
Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
9 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: CUPOM_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@cupom_center/mcp@0.1.0"
],
"env": {
"CUPOM_API_KEY": "your-cupom-api-key-here"
}
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
Cupom Center MCP
Servidor MCP local que ajuda agentes de IA a integrar sistemas clientes à API REST do Cupom Center.
O servidor roda no computador do cliente por stdio. Ele não hospeda modelo de IA e não abre uma porta de rede: recebe chamadas MCP do host local e acessa https://api.cupom.center com a API key do projeto.
O que ele faz
Além de representar os endpoints REST como ferramentas MCP, o servidor ensina o agente a seguir o ciclo correto:
- descobrir cupons elegíveis sem reservar ou consumir;
- calcular o desconto e reservar uma quote temporária;
- confirmar o resgate com o mesmo contexto;
- registrar pagamento somente após confirmação externa;
- consultar e reconciliar a operação;
- reverter usos e budgets sem fingir que movimentou dinheiro.
recommend_integration_flow decide o fluxo sem chamar a API e sem consumir a franquia do Cupom Center. As demais ferramentas acessam a REST e estão sujeitas ao rate limit e à medição de consumo da organização.
Requisitos
- Node.js 20 ou superior;
- uma API key criada para o projeto e ambiente corretos no Cupom Center;
- permissões compatíveis com as ferramentas usadas.
| Operação | Permissão |
|---|---|
| Descoberta, consulta de operação | COUPON_READ |
| Emissão, consulta e revogação de código individual | COUPON_ISSUE e COUPON_READ |
| Quote, resgate e reversão | COUPON_REDEEM |
| Pagamento no resgate ou posterior | PAYMENT_WRITE |
Organização, ambiente e projeto são sempre derivados da API key. O MCP não permite selecionar outro tenant por argumento.
Desenvolvimento local
cd mcp
bun install
bun run build
Instalação publicada
Depois da publicação no npm, fixe uma versão no host MCP:
{
"mcpServers": {
"cupom-center": {
"command": "npx",
"args": ["-y", "@cupom_center/mcp@0.1.0"],
"env": {
"CUPOM_API_KEY": "cpm_..."
}
}
}
}
As instruções de release, npm Trusted Publishing e MCP Registry estão em PUBLISHING.md.
Configure o host MCP para executar o arquivo compilado usando um caminho absoluto:
{
"mcpServers": {
"cupom-center": {
"command": "node",
"args": ["/caminho/absoluto/para/Cupom/mcp/dist/index.js"],
"env": {
"CUPOM_API_KEY": "cpm_...",
"CUPOM_API_URL": "https://api.cupom.center"
}
}
}
}
CUPOM_API_URL é opcional e usa https://api.cupom.center por padrão. HTTP só é aceito para localhost, facilitando desenvolvimento sem permitir credenciais em conexões remotas inseguras.
CUPOM_API_TIMEOUT_MS é opcional, usa 20 segundos por padrão e aceita valores entre 1.000 e 120.000 ms.
O servidor pode iniciar sem uma API key para consultar o guia e executar recommend_integration_flow. As ferramentas que acessam a REST retornarão um erro de configuração até CUPOM_API_KEY ser definida.
Para produção, prefira que o instalador recupere a API key do cofre de credenciais do sistema operacional. Configurá-la diretamente no JSON do host é simples, mas exige proteger esse arquivo contra leitura, backup ou compartilhamento indevido.
Ferramentas
recommend_integration_flowfind_eligible_couponsquote_single_couponquote_multiple_couponsselect_coupons_for_unitscreate_coupon_issuanceget_coupon_issuancerevoke_coupon_issuanceredeem_single_couponredeem_multiple_couponsget_coupon_operationrecord_operation_paymentreverse_operation
O recurso MCP cupom://integration-guide contém as regras de decisão compartilhadas pelo servidor.
Segurança e retries
- O servidor nunca escreve a API key em logs ou respostas.
stdouté reservado exclusivamente ao protocolo MCP; diagnósticos usamstderr.- Requisições com efeito comercial não recebem retry automático.
- Depois de timeout, não altere os dados e tente novamente às cegas.
- Emissão usa
Idempotency-Key; repetir a mesma chave exige o mesmo comando. - Resgates devem preservar carrinho, contexto, códigos, ordem, estratégia, quote e pagamento.
- Cupom Center registra pagamentos confirmados pelo cliente, mas não cobra nem estorna dinheiro.
- Reversões são integrais e liberam usos e budgets; o estorno financeiro continua sendo responsabilidade do provedor de pagamento do cliente.
O MCP não administra cupons, campanhas, organizações, membros ou API keys. Essas operações pertencem à superfície GraphQL autenticada do painel.
Validação
bun run typecheck
bun run build
O projeto evita testes unitários isolados. A validação de protocolo deve ser feita conectando o binário compilado a um cliente MCP ou ao MCP Inspector, e a validação da REST deve usar um ambiente/projeto de homologação.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
