Skip to main content
CH

Chargebee

v0.1.1API Key

Orquestração global de cobrança de assinatura usada por SaaS da LatAm (Platzi, Truora). Lógica de assinatura estilo Stripe por cima de gateways locais. Zero overlap com Vindi/Iugu — esse é o padrão global-SaaS.

15 ferramentas2 env vars🌐 GLOBALestável no npm

O que seu agente faz

O Chargebee dá ao seu agente 15 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.

  • create_subscriptionCreate a new subscription in Chargebee. Provide either a nested `customer` object (with email/first_name/last_name) for a new customer, or pass an existing `customer_id` via nested customer or top-level field.
  • retrieve_subscriptionRetrieve a subscription by ID
  • update_subscriptionUpdate a subscription. Accepts any Chargebee subscription fields (plan_id, plan_quantity, coupon_ids, addons, billing_cycles, etc.)
Exemplo de chamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_subscription", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-chargebee

Quickstart

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "chargebee": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-chargebee"
      ],
      "env": {
        "CHARGEBEE_SITE": "<your_chargebee_site>",
        "CHARGEBEE_API_KEY": "<your_chargebee_api_key>"
      }
    }
  }
}

Depois de reiniciar, seu agente pode chamar qualquer uma das 15 ferramentas abaixo — teste create_subscription primeiro.

Variáveis de ambiente · 2

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

CHARGEBEE_SITE
obrigatório

Chargebee site subdomain (e.g. 'acme' for acme.chargebee.com, 'acme-test' for test site)

CHARGEBEE_API_KEY
obrigatóriosecret

Chargebee API key (full-access or restricted) from Settings > API Keys

Ferramentas disponíveis · 15

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

WRITEcreate_subscription
Create a new subscription in Chargebee. Provide either a nested `customer` object (with email/first_name/last_name) for a new customer, or pass an existing `customer_id` via nested customer or top-level field.
READretrieve_subscription
Retrieve a subscription by ID
WRITEupdate_subscription
Update a subscription. Accepts any Chargebee subscription fields (plan_id, plan_quantity, coupon_ids, addons, billing_cycles, etc.)
DELETEcancel_subscription
Cancel a subscription. By default cancels immediately; set end_of_term=true to cancel at period end.
WRITEreactivate_subscription
Reactivate a cancelled or paused subscription
READlist_subscriptions
List subscriptions. Pass filters as a free-form object using Chargebee's field[operator]=value format, e.g. { "status[is]": "active", "customer_id[is]": "cust_123" }.
WRITEcreate_customer
Create a customer in Chargebee. At least one of email, first_name, or last_name is required.
READretrieve_customer
Retrieve a customer by ID

Frameworks compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Qualquer cliente MCPProtocolo

Perguntas frequentes

Rode `npx -y @codespar/mcp-chargebee` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
Chargebee — MCP server · 15 tools | CodeSpar