KosmoKrator

payments

Chargebee MCP Integration for Claude Agent SDK

Connect Chargebee to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 7 read 0 write Bearer token auth
Submit Chargebee feedback View package source

Connect Chargebee to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Chargebee MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "mcpServers": {
    "kosmokrator-chargebee": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=chargebee",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=chargebee --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Chargebee instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Chargebee Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the Chargebee integration catalog.

MCP toolSource functionTypeDescription
integration__chargebee__chargebee_list_subscriptions chargebee.chargebee_list_subscriptions Read List subscriptions from Chargebee. Supports filtering by state (active, cancelled, non_renewing, paused, in_trial, future) and pagination. Returns subscription details including plan, status, and billing period.
integration__chargebee__chargebee_get_subscription chargebee.chargebee_get_subscription Read Retrieve detailed information about a specific Chargebee subscription by its ID, including plan details, billing period, status, and associated customer.
integration__chargebee__chargebee_list_customers chargebee.chargebee_list_customers Read List customers from Chargebee with pagination. Returns customer details including email, name, company, and billing address.
integration__chargebee__chargebee_get_customer chargebee.chargebee_get_customer Read Retrieve detailed information about a specific Chargebee customer by their ID, including contact details, billing address, and payment method.
integration__chargebee__chargebee_list_invoices chargebee.chargebee_list_invoices Read List invoices from Chargebee. Supports filtering by status (paid, posted, payment_due, not_paid, voided, pending) and pagination.
integration__chargebee__chargebee_get_invoice chargebee.chargebee_get_invoice Read Retrieve detailed information about a specific Chargebee invoice by its ID, including line items, totals, tax, and payment status.
integration__chargebee__chargebee_get_current_user chargebee.chargebee_get_current_user Read Retrieve the current authenticated user information from Chargebee. Use this to verify credentials are working and check user details.

Related Chargebee Pages

Chargebee CLIUse direct JSON commands instead of MCP discovery. Chargebee MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.