KosmoKrator

payments

ChargeOver MCP Integration for OpenAI Agents SDK

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

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

ChargeOver MCP Config for OpenAI Agents SDK

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

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

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