MCP App Store
by KeenEthics
Zupy icon

Zupy MCP Server for ChatGPT

By Zupy, LLC

Overview

Create coupons and loyalty programs for your business in the chat and publish them on Zupy, for WhatsApp, Google Wallet and Apple Wallet. Fabinho, Zupy's specialist, builds the coupon or the program with you, shows a preview and publishes only after you confirm.

How to connect

  1. ChatGPT: Open the Zupy listing in the ChatGPT app directory and choose Connect. ChatGPT listing Zupy exposes 34 tools here.

Tools

adjust_program

ChatGPT
Ajusta o programa de fidelidade que já está no ar: muda nome e pontos de prêmios (mudar), tira prêmios (tirar: a Zupy pausa, nunca apaga) e troca o nome do programa. Use os ids de get_store_program. Em duas etapas: a primeira chamada devolve a prévia (o que muda, o que sai, quantos clientes já têm pontos e quantos cupons resgatados continuam valendo, e os avisos); só depois que o Lojista confirmar, chame de novo só com proposta_id, versao e confirmacao_token. Prêmio novo entra por calculate_reward_ladder e publish_program. Cores e banner ficam no painel.

build_image_request

ChatGPT
Monta um texto pronto para o Lojista colar no ChatGPT ou no Gemini e gerar a imagem de um prêmio, do cartão do programa ou do cupom, no formato que a Zupy usa. Não gera a imagem. A imagem é opcional e não impede publicar.

build_launch_kit

ChatGPT
Monta o kit de lançamento: para o cupom, post, mensagem de WhatsApp e checklist antes de divulgar; para o programa, a frase da equipe, o roteiro de treino, o texto do cartaz, a mensagem de divulgação e o alerta do telefone no balcão. Termine a conversa com ele.

calculate_coupon_cost

ChatGPT
Calcula o custo do cupom por uso, a contribuição do pedido com e sem o cupom e quantos pedidos a mais o benefício exige, e guarda o cupom escolhido como proposta. Devolve também as condições da Zupy para explicar ao Lojista. Com o diagnóstico, devolve o enquadramento (a dor e o objetivo numa linha) para conferir com o dono. Use os números que esta ferramenta devolver.

calculate_reward_ladder

ChatGPT
Calcula os pontos, a visita em que cada prêmio fica ao alcance, o custo de cada prêmio, uma estimativa do mês e avisos para a escada de prêmios de um programa de fidelidade, e guarda a escada como proposta. Com o diagnóstico, devolve o enquadramento (a dor e o objetivo numa linha) para conferir com o dono. Use os números que esta ferramenta devolver; não faça a conta por conta própria.

compare_stores

ChatGPT
Põe lado a lado de 2 a 5 lojas que a conta pode administrar: programa, prêmios, cupons (textos, regras, validade e imagens) e números agregados (clientes no programa, cupons resgatados e usados em 30 dias). Nunca traz dado pessoal de cliente: para isso, o painel.

coupon_first_steps

ChatGPT
Primeiros passos depois que o cupom vai ao ar: como o cliente usa (sem instalar app, guarda na carteira do celular, mostra antes de pagar), como a loja valida no Zupy Scanner (links oficiais do iPhone, do Android e do navegador), o teste antes de divulgar, como cadastrar a equipe e uma mensagem pronta para a equipe. Use logo depois de publicar o cupom e sempre que o dono perguntar como validar. Não invente passo nem link.

coupon_performance

ChatGPT
Por campanha de cupom da loja (não os prêmios do programa) no período (mes: 30 dias; trimestre: 90; desde_o_inicio: todo o histórico): quantos clientes pegaram, quantos usaram, quantos venceram, a taxa de uso (%) e o tempo médio até o uso (horas). Traz a situação de cada cupom e as listas ninguem_pegou (no ar, sem ninguém) e pouco_usados. Use o id com edit_coupon para mudar texto ou regras. Só números, nunca dados de clientes.

create_store

ChatGPT
Cria a loja de uma conta nova na Zupy (conta grátis, 20 cupons), quando a conexão ainda não tem loja. Pergunte o nome da loja; pergunte se o WhatsApp da loja é o mesmo da conta e o e-mail da loja (sem eles, valem os da conta). A primeira chamada devolve a prévia; mostre ao dono e só chame de novo, com o confirmacao_token e os mesmos dados, depois do sim. A loja criada vira a da conversa; depois peça o logo (set_store_logo). Conta que já tem loja recebe o nome dela para usar select_store.

customers_near_reward

ChatGPT
Por prêmio do programa no ar: quantos clientes ativos (com qualquer movimento nos últimos 90 dias) têm esse prêmio como o próximo, e quantos estão perto dele. Perto é a uma visita (a média de pontos por visita da loja, em uma_visita) ou, se o dono pedir, a N pontos. Só contagens, nunca quem são os clientes.

edit_coupon

ChatGPT
Muda o nome, a descrição ou as regras de um cupom que já existe na loja (cupom de campanha ou o de boas-vindas), pelo mesmo caminho do painel. A primeira chamada devolve a prévia com o antes e o depois; mostre ao dono e só chame de novo, com o confirmacao_token e o mesmo texto, depois do sim. Use o id de cupons_de_campanha ou boas_vindas de get_store_program. Nunca mande o dono colar o texto no painel.

edit_reward

ChatGPT
Muda o nome, a descrição ou as regras de um prêmio do programa de fidelidade da loja, pelo mesmo caminho do painel. Para mudar os pontos ou tirar um prêmio, use adjust_program. A primeira chamada devolve a prévia com o antes e o depois; só chame de novo, com o confirmacao_token e o mesmo texto, depois do sim.

get_store_balance

ChatGPT
Lê o saldo da loja conectada e diz, para cada cupom de campanha no ar ou pausado por falta de saldo, quantos usos o saldo cobre, e o que acontece quando o saldo acaba. Só lê: nunca cobra nem movimenta dinheiro. Precisa que o Lojista tenha entrado na Zupy.

get_store_program

ChatGPT
Lê o programa de fidelidade da loja conectada: nome, pontos, o cupom de boas-vindas, todos os cupons de campanha (cupons_de_campanha: os mesmos do painel, com situacao no_ar, pausado ou expirado, descrição, regras e validade) e os prêmios, cada um com imagem_url (a imagem atual, ou nulo); os prêmios com no_ar (o cliente da loja vê ou não) e a situação (no_ar, pausado, oculto, acima_do_plano ou programa_nao_publicado). Precisa que o Lojista tenha entrado na Zupy.

list_stores

ChatGPT
Lista as lojas em que a conta conectada pode trabalhar (id, nome, cidade, programa) e marca a ativa da conversa. Use quando o dono tiver mais de uma loja ou pedir outra loja; depois chame select_store. Aceita uma busca por nome.

network_overview

ChatGPT
Só para o suporte da Zupy (superadministrador): todas as lojas vivas (programa no ar ou assinatura ativa, em teste ou em atraso) lado a lado, com pedidos e resgates do período contra o anterior (semana ou mes). Aponta as lojas que caíram (pedidos 30% abaixo, com base de 10) e as paradas, primeiro. Qualquer outro usuário recebe recusa. Só números.

open_in_dashboard

ChatGPT
Devolve o link da tela do painel da Zupy para o Lojista trocar a imagem (banner) ou ajustar um detalhe: a edição do cupom (use o cupom_id que publish_coupon devolveu), os prêmios do programa ou o cartão (Regras & Visual, com o banner e as cores). Gere a imagem antes com build_image_request.

pause_coupon

ChatGPT
Pausa um cupom de campanha que está no ar na loja, ou retoma um cupom pausado, pelo mesmo caminho dos botões do painel. Use o id de cupons_de_campanha (get_store_program). A primeira chamada devolve a prévia (o cupom e o que acontece); mostre ao dono e só chame de novo, com o confirmacao_token, depois do sim. Nunca mande o dono ao painel para pausar.

publish_coupon

ChatGPT
Publica na loja conectada o cupom de campanha calculado por calculate_coupon_cost (nome, texto, benefício e validade da proposta). Em duas etapas: a primeira chamada (sem confirmacao_token) devolve a prévia do cupom para o Lojista conferir; só depois que ele confirmar, chame de novo com o confirmacao_token. Para mudar o cupom, calcule de novo: esta ferramenta não aceita outros valores. Um cupom já publicado continua no ar; um cálculo novo publica outro cupom.

publish_program

ChatGPT
Coloca no ar o programa de fidelidade da loja conectada: o cartão, o nome do programa e dos pontos e os prêmios da escada calculada por calculate_reward_ladder. Em duas etapas: a primeira chamada (sem confirmacao_token) devolve a prévia, inclusive o que acontece com o presente de boas-vindas; só depois que o Lojista confirmar, chame de novo com o confirmacao_token. Se o programa já está no ar, entram só os prêmios novos. Cada prêmio entra com o título e a descrição que o dono aprovou, guardados no calculate_reward_ladder; mande em premios o que ele viu, e a Zupy confere. Com dois ou mais cupons que podem virar o boas-vindas, a prévia lista os boas_vindas_candidatos: pergunte ao dono qual e chame de novo com o boas_vindas_id. O cartão segue as cores do logo, que vêm na prévia e são gravadas no sim; outra cor só no painel.

publish_rewards

ChatGPT
Publica na loja conectada os Prêmios de uma escada calculada por calculate_reward_ladder. Em duas etapas: a primeira chamada (sem confirmacao_token) devolve a prévia para o Lojista conferir; só depois que ele confirmar, chame de novo com o confirmacao_token. Não aceita pontos, nomes, textos ou custos diferentes dos calculados.

reward_performance

ChatGPT
Ranking dos prêmios do programa de fidelidade da loja no período (mes: últimos 30 dias; trimestre: 90; desde_o_inicio: todo o histórico): resgates e quantos deles foram usados, venceram ou estão em aberto, custo e se o custo é real ou estimado, com os mais resgatados e os nunca resgatados. São os números do relatório de prêmios do painel. Cada prêmio vem com o id e os pontos para seguir com adjust_program. Cupons de campanha não entram aqui.

select_store

ChatGPT
Troca a loja em que a conversa trabalha, pelo id que list_stores devolveu. Tudo o que for lido ou gravado depois vale para essa loja. Diga ao dono o nome da loja escolhida antes de seguir.

set_card_image

ChatGPT
Define uma imagem como banner do cartão do programa de fidelidade da loja conectada (o cartão do Wallet e da página do programa). Use a imagem que o Lojista anexou ou que você gerou na conversa (o ChatGPT entrega o arquivo). Para cupom use set_coupon_image; para prêmio, set_reward_image. Só confirme sucesso quando a Zupy devolver status atualizado. Se a imagem não chegar como arquivo, peça para o Lojista anexar a imagem, ou mande o link do painel (open_in_dashboard).

set_coupon_image

ChatGPT
Define uma imagem como banner de um cupom da loja conectada. Use o id do cupom de get_store_program e a imagem que o Lojista anexou ou que você gerou na conversa (o ChatGPT entrega o arquivo). Só confirme sucesso quando a Zupy devolver status atualizado; aí mande ao dono o link do cupom (link), onde ele vê o cartão na Wallet; o imagem_url é só referência de estilo para a próxima imagem, nunca mande ao dono. Se a imagem não chegar como arquivo, peça para o Lojista anexar a imagem, ou mande o link do painel (open_in_dashboard).

set_reward_image

ChatGPT
Define uma imagem como banner de um prêmio do programa de fidelidade da loja conectada. Use o id do prêmio de get_store_program (lista premios) e a imagem que o Lojista anexou ou que você gerou na conversa (o ChatGPT entrega o arquivo). Para cupom de campanha, use set_coupon_image. Só confirme sucesso quando a Zupy devolver status atualizado. Se a imagem não chegar como arquivo, peça para o Lojista anexar a imagem, ou mande o link do painel (open_in_dashboard).

store_activity

ChatGPT
Dias da semana e horários fortes e fracos da loja no período (mes: 30 dias; trimestre: 90), no fuso da loja, pelo relatório de movimento do painel. O mais fraco é entre os dias e horas com movimento; dia sem nenhum evento pode ser dia fechado (sem_movimento). Com pouco_movimento, não tire conclusão. Use para sugerir um cupom para o dia ou horário fraco, depois de perguntar se a loja abre nesse dia.

store_overview

ChatGPT
Resumo da loja no período (semana: últimos 7 dias; mes: últimos 30), comparado com o período anterior de mesmo tamanho: pedidos, resgates, clientes que voltaram (segunda visita), retenção e os segmentos que pedem atenção. São os números da tela Relatórios do painel, só agregados. Diga se cada número é real ou estimado e transforme em no máximo três conselhos com ação; nunca cite número que esta resposta não trouxe.

suggest_coupon_ideas

ChatGPT
Sugere até 3 ideias de cupom de campanha para o objetivo e a força escolhidos, com os itens do cardápio da loja: público, benefício, condição, prazo, canal, o que medir e o texto pronto do cupom. Use só as ideias e os itens que esta ferramenta devolver; não invente preço nem item.

suggest_program_card

ChatGPT
Sugere nomes para o programa de fidelidade e para os pontos no tom do público, a regra de pontuação padrão, o plano recomendado pelo número de prêmios e como apresentar o presente de boas-vindas.

suggest_rewards

ChatGPT
Sugere os prêmios de um grupo da escada (fazer voltar, recompensar quem é fiel ou virar fã) na força que o dono escolheu para o grupo (leve, media ou explosiva): até 3 degraus na mesma força, de categorias diferentes (um presente, um preço, algo especial ou exclusivo) e em ordem crescente de valor, cada um com o que o cliente ganha, a compra exigida, o custo e o porquê em uma frase. Peça um grupo por vez, com proposito e forca. Com o diferencial, a experiência que só a casa tem entra no grupo. É ponto de partida: traga também ideias suas a partir do que o dono contou, e a escolha é dele. Use antes de calculate_reward_ladder.

undo_last_change

ChatGPT
Desfaz o último ajuste feito pelo Fabinho no programa da loja (adjust_program): volta nome e pontos dos prêmios, reativa os prêmios que saíram e o nome do programa. Só a última mudança, só se a loja ainda estiver como o ajuste deixou, e uma vez só; cupons já resgatados continuam valendo. Em duas etapas: sem confirmacao_token devolve a prévia; depois do sim do Lojista, chame com o confirmacao_token.

who_is_connected

ChatGPT
Diz se a conversa já está conectada a uma conta Zupy e, se estiver, a loja: nome, tipo de negócio, cidade, país, idioma e moeda, se já tem logo (tem_logo), os cupons no ar e se o programa de fidelidade está no ar, em rascunho ou não existe. Chame no começo da conversa, antes da primeira pergunta ao dono: nunca pede o Login. Com conectado=false, siga a descoberta normal (negócio, tipo de negócio e logo). Com a loja, use os dados e não pergunte de novo o que ela já diz. Com varias_lojas=true, pergunte em qual loja trabalhar e chame select_store.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/zupy"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/zupy)