KosmoKrator

payments

Chargify CLI for AI Agents

Use the Chargify CLI from KosmoKrator to call Chargify tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 7 read 0 write API key auth

Chargify CLI Setup

Chargify can be configured headlessly with `kosmokrator integrations:configure chargify`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure chargify --set api_key="$CHARGIFY_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor chargify --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

KeyEnv varTypeRequiredLabel
api_key CHARGIFY_API_KEY Secret secret yes API Key
subdomain CHARGIFY_SUBDOMAIN Text string no Subdomain
url CHARGIFY_URL URL url no Base URL

Call Chargify Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call chargify.chargify_list_subscriptions '{
  "page": 1,
  "per_page": 1,
  "state": "example_state"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:chargify chargify_list_subscriptions '{
  "page": 1,
  "per_page": 1,
  "state": "example_state"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs chargify --json
kosmo integrations:docs chargify.chargify_list_subscriptions --json
kosmo integrations:schema chargify.chargify_list_subscriptions --json
kosmo integrations:search "Chargify" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Chargify.

chargify.chargify_list_subscriptions

Read read

List subscriptions from Chargify. Supports filtering by state (active, past_due, canceled, expired, trial, etc.) and pagination.

Parameters
page, per_page, state

Generic CLI call

kosmo integrations:call chargify.chargify_list_subscriptions '{"page":1,"per_page":1,"state":"example_state"}' --json

Provider shortcut

kosmo integrations:chargify chargify_list_subscriptions '{"page":1,"per_page":1,"state":"example_state"}' --json

chargify.chargify_get_subscription

Read read

Get detailed information for a single Chargify subscription by ID.

Parameters
subscription_id

Generic CLI call

kosmo integrations:call chargify.chargify_get_subscription '{"subscription_id":1}' --json

Provider shortcut

kosmo integrations:chargify chargify_get_subscription '{"subscription_id":1}' --json

chargify.chargify_list_customers

Read read

List customers from Chargify. Supports pagination with page and per_page parameters.

Parameters
page, per_page

Generic CLI call

kosmo integrations:call chargify.chargify_list_customers '{"page":1,"per_page":1}' --json

Provider shortcut

kosmo integrations:chargify chargify_list_customers '{"page":1,"per_page":1}' --json

chargify.chargify_get_customer

Read read

Get detailed information for a single Chargify customer by ID.

Parameters
customer_id

Generic CLI call

kosmo integrations:call chargify.chargify_get_customer '{"customer_id":1}' --json

Provider shortcut

kosmo integrations:chargify chargify_get_customer '{"customer_id":1}' --json

chargify.chargify_list_products

Read read

List products available in Chargify. Supports pagination with page and per_page parameters.

Parameters
page, per_page

Generic CLI call

kosmo integrations:call chargify.chargify_list_products '{"page":1,"per_page":1}' --json

Provider shortcut

kosmo integrations:chargify chargify_list_products '{"page":1,"per_page":1}' --json

chargify.chargify_list_invoices

Read read

List invoices from Chargify. Supports filtering by status (open, paid, pending, voided) and pagination.

Parameters
page, per_page, status

Generic CLI call

kosmo integrations:call chargify.chargify_list_invoices '{"page":1,"per_page":1,"status":"example_status"}' --json

Provider shortcut

kosmo integrations:chargify chargify_list_invoices '{"page":1,"per_page":1,"status":"example_status"}' --json

chargify.chargify_get_current_user

Read read

Get the currently authenticated Chargify user. Useful for verifying API credentials.

Parameters
none

Generic CLI call

kosmo integrations:call chargify.chargify_get_current_user '{}' --json

Provider shortcut

kosmo integrations:chargify chargify_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

chargify.chargify_list_subscriptions

List subscriptions from Chargify. Supports filtering by state (active, past_due, canceled, expired, trial, etc.) and pagination.

Operation
Read read
Schema command
kosmo integrations:schema chargify.chargify_list_subscriptions --json
ParameterTypeRequiredDescription
page integer no Page number for pagination (default: 1).
per_page integer no Number of results per page, max 200 (default: 20).
state string no Filter by subscription state: active, past_due, canceled, expired, trial, on_hold, pending, deferred, etc.

chargify.chargify_get_subscription

Get detailed information for a single Chargify subscription by ID.

Operation
Read read
Schema command
kosmo integrations:schema chargify.chargify_get_subscription --json
ParameterTypeRequiredDescription
subscription_id integer yes The Chargify subscription ID.

chargify.chargify_list_customers

List customers from Chargify. Supports pagination with page and per_page parameters.

Operation
Read read
Schema command
kosmo integrations:schema chargify.chargify_list_customers --json
ParameterTypeRequiredDescription
page integer no Page number for pagination (default: 1).
per_page integer no Number of results per page, max 200 (default: 20).

chargify.chargify_get_customer

Get detailed information for a single Chargify customer by ID.

Operation
Read read
Schema command
kosmo integrations:schema chargify.chargify_get_customer --json
ParameterTypeRequiredDescription
customer_id integer yes The Chargify customer ID.

chargify.chargify_list_products

List products available in Chargify. Supports pagination with page and per_page parameters.

Operation
Read read
Schema command
kosmo integrations:schema chargify.chargify_list_products --json
ParameterTypeRequiredDescription
page integer no Page number for pagination (default: 1).
per_page integer no Number of results per page, max 200 (default: 20).

chargify.chargify_list_invoices

List invoices from Chargify. Supports filtering by status (open, paid, pending, voided) and pagination.

Operation
Read read
Schema command
kosmo integrations:schema chargify.chargify_list_invoices --json
ParameterTypeRequiredDescription
page integer no Page number for pagination (default: 1).
per_page integer no Number of results per page, max 200 (default: 20).
status string no Filter by invoice status: open, paid, pending, voided.

chargify.chargify_get_current_user

Get the currently authenticated Chargify user. Useful for verifying API credentials.

Operation
Read read
Schema command
kosmo integrations:schema chargify.chargify_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.