KosmoKrator

payments

ChargeOver MCP Integration for Claude Agent SDK

Connect ChargeOver 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 ChargeOver feedback View package source

Connect ChargeOver 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.

ChargeOver MCP Config for Claude Agent SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

Expose only ChargeOver 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.

ChargeOver Tools Visible to Claude Agent SDK

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

MCP toolSource functionTypeDescription
integration__chargeover__chargeover_list_customers chargeover.chargeover_list_customers Read List customers from ChargeOver. Returns customer records with contact details, company info, and account status. Supports pagination and status filtering.
integration__chargeover__chargeover_get_customer chargeover.chargeover_get_customer Read Get detailed information about a specific ChargeOver customer by ID, including contact details, billing address, account balance, and payment methods.
integration__chargeover__chargeover_list_subscriptions chargeover.chargeover_list_subscriptions Read List subscriptions from ChargeOver. Returns subscription details including plan, billing cycle, status, and associated customer. Supports filtering by customer.
integration__chargeover__chargeover_list_invoices chargeover.chargeover_list_invoices Read List invoices from ChargeOver. Returns invoice details including amounts, dates, line items, and payment status. Supports pagination and status filtering.
integration__chargeover__chargeover_get_invoice chargeover.chargeover_get_invoice Read Get detailed information about a specific ChargeOver invoice by ID, including line items, totals, tax, applied payments, and invoice URL.
integration__chargeover__chargeover_list_transactions chargeover.chargeover_list_transactions Read List transactions (payments) from ChargeOver. Returns payment records including amounts, methods, dates, and associated customers and invoices.
integration__chargeover__chargeover_get_current_user chargeover.chargeover_get_current_user Read Get information about the currently authenticated ChargeOver user and account. Useful for verifying connectivity and understanding which account the integration is connected to.

Related ChargeOver Pages

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