ribbo-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| check_entitlementsA | Consulta as capacidades (entitlements) das assinaturas vivas de um cliente — o que liberar no seu SaaS. Informe external_id OU email. |
| list_subscriptionsB | Lista as assinaturas do tenant. Filtros opcionais por status (CSV), offer_slug, e paginação por cursor (limit, after). |
| get_subscriptionB | Estado atual de UMA assinatura (qualquer status). Útil para reconciliar um webhook perdido. |
| get_gateway_eventsB | Timeline do que o gateway respondeu para uma assinatura (aprovação/recusa/estorno/chargeback). |
| get_paymentC | Detalhe de um pagamento, com a decomposição em items (plano/bump/juros). |
| get_customer_subscriptionsB | Todas as assinaturas de um cliente (qualquer status), pelo seu external_id. |
| get_customer_paymentsB | Histórico de pagamentos de um cliente (recorrente + avulso), paginado por cursor. |
| get_referral_linkB | Código/link de indicação de um cliente + recompensa e progresso. Informe external_id OU email. |
| get_renewal_campaign_linkA | Link de renovação de um cliente numa campanha (cria-ou-obtém, idempotente). Exige escopo write. |
| list_renewal_campaign_linksC | Lista todos os links de uma campanha de renovação (cursor). |
| get_payment_linkB | Link público de pagamento da fatura EM ABERTO de uma assinatura. 409 se não há fatura aberta. |
| get_order_payment_linkB | Link de re-acesso ao Pix de um pedido pendente (compra avulsa OU adiantamento de renovação) — a 2ª via para reenviar ao cliente. 409 se não há Pix pendente para reabrir. |
| create_subscriptionA | Cria uma assinatura SEM cartão (Pix manual ou migração). Idempotente por (cliente, oferta). Escopo write. |
| change_planA | Troca o plano de uma assinatura (upgrade imediato com proração; downgrade/troca de ciclo agendados). Escopo write. |
| cancel_plan_changeA | Cancela uma troca de plano AGENDADA. 422 se não houver troca agendada. Escopo write. |
| cancel_subscriptionB | Cancela uma assinatura (terminal, idempotente). 422 se houver QR Pix pagável. Escopo write. |
| charge_nowC | Enfileira uma cobrança imediata no cartão salvo da assinatura (202). Escopo write. |
| reschedule_subscriptionA | Reagenda a próxima cobrança (NÃO cobra). next_billing_at deve ser futuro (ISO-8601). Escopo write. |
| remove_couponB | Remove o cupom dos ciclos futuros de uma assinatura. Escopo write. |
| create_renewal_linkC | Gera um link de renovação avulsa (expira em 7 dias). Escopo write. |
| create_payment_method_linkA | Gera um link para o cliente trocar de forma de pagamento (cartão/Pix), sem cobrança, single-use, 7 dias. Escopo write. |
| refund_paymentC | Estorna um pagamento (total/parcial). Se atingir runway pré-pago, retorna 422 requires_confirmation=runway; reenvie com confirm_runway=true. Escopo write. |
| update_customerB | Atualiza nome/email/telefone de um cliente (doc e external_id não são editáveis). Escopo write. |
| update_customer_emailC | Atualiza o e-mail de um cliente (sincroniza com o gateway). Escopo write. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 24 tools
Each tool targets a distinct resource and action, with clear boundaries between similar operations like get_payment_link (subscription invoice) and get_order_payment_link (one-off Pix order). Detailed descriptions further prevent ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., list_subscriptions, create_renewal_link, refund_payment). The few compound names like get_gateway_events still fit the pattern with nested nouns.
24 tools is on the higher end for a single server, but the breadth is justified by the comprehensive billing domain (subscriptions, payments, customers, links). It remains manageable and each tool has a specific purpose.
The core subscription and payment lifecycles are well covered, but there are notable gaps: no get_customer or create_customer, no apply_coupon or add_coupon, no direct payment method management beyond a link, and no way to list all payments for a subscription. These create dead ends for some workflows.