KosmoKrator

payments

Chargebee MCP Integration for OpenAI Agents SDK

Connect Chargebee to OpenAI Agents 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 OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Chargebee MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "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 OpenAI Agents

OpenAI Agents 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 OpenAI AgentsClient-level gateway setup.