Can I use Ko-fi as a CLI?

Yes. KosmoKrator exposes a Ko-fi CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Ko-fi through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Ko-fi tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Ko-fi credentials stored?

Ko-fi credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Ko-fi MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Ko-fi CLI for AI Agents

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

7 functions 7 read 0 write Bearer token auth

Submit Ko-fi feedback View package source

Ko-fi CLI Setup

Ko-fi can be configured headlessly with `kosmokrator integrations:configure ko-fi`.

# 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 ko-fi --set access_token="$KO_FI_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor ko-fi --json
kosmokrator integrations:status --json

Credentials

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

Key	Env var	Type	Required	Label
`access_token`	`KO_FI_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`KO_FI_URL`	URL `url`	no	API Base URL

Call Ko-fi Headlessly

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

kosmo integrations:call ko-fi.ko-fi_list_supporters '{
  "page": 1,
  "limit": 1
}' --json

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

kosmo integrations:ko-fi ko-fi_list_supporters '{
  "page": 1,
  "limit": 1
}' --json

Agent Discovery Commands

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

kosmo integrations:docs ko-fi --json
kosmo integrations:docs ko-fi.ko-fi_list_supporters --json
kosmo integrations:schema ko-fi.ko-fi_list_supporters --json
kosmo integrations:search "Ko-fi" --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 Ko-fi.

`ko-fi.ko-fi_list_supporters`

Read read

List all supporters who have donated or subscribed to your Ko-fi page. Returns supporter names, emails, and contribution history.

Parameters: page, limit

Generic CLI call

kosmo integrations:call ko-fi.ko-fi_list_supporters '{"page":1,"limit":1}' --json

Provider shortcut

kosmo integrations:ko-fi ko-fi_list_supporters '{"page":1,"limit":1}' --json

`ko-fi.ko-fi_get_supporter`

Read read

Get detailed information about a single Ko-fi supporter by their email address. Returns full supporter profile including contribution history and status.

Parameters: email

Generic CLI call

kosmo integrations:call ko-fi.ko-fi_get_supporter '{"email":"example_email"}' --json

Provider shortcut

kosmo integrations:ko-fi ko-fi_get_supporter '{"email":"example_email"}' --json

`ko-fi.ko-fi_list_transactions`

Read read

List all transactions on your Ko-fi page including donations, subscriptions, and shop orders. Returns transaction details with amounts and dates.

Parameters: type, page, limit

Generic CLI call

kosmo integrations:call ko-fi.ko-fi_list_transactions '{"type":"example_type","page":1,"limit":1}' --json

Provider shortcut

kosmo integrations:ko-fi ko-fi_list_transactions '{"type":"example_type","page":1,"limit":1}' --json

`ko-fi.ko-fi_list_commissions`

Read read

List all commission requests on your Ko-fi page. Returns commission details including status, requester info, and pricing.

Parameters: status, page, limit

Generic CLI call

kosmo integrations:call ko-fi.ko-fi_list_commissions '{"status":"example_status","page":1,"limit":1}' --json

Provider shortcut

kosmo integrations:ko-fi ko-fi_list_commissions '{"status":"example_status","page":1,"limit":1}' --json

`ko-fi.ko-fi_get_commission`

Read read

Get detailed information about a single Ko-fi commission by its ID. Returns full commission data including description, status, and requester details.

Parameters: commission_id

Generic CLI call

kosmo integrations:call ko-fi.ko-fi_get_commission '{"commission_id":"example_commission_id"}' --json

Provider shortcut

kosmo integrations:ko-fi ko-fi_get_commission '{"commission_id":"example_commission_id"}' --json

`ko-fi.ko-fi_list_shop_items`

Read read

List all items in your Ko-fi shop. Returns item names, descriptions, prices, and availability.

Parameters: page, limit

Generic CLI call

kosmo integrations:call ko-fi.ko-fi_list_shop_items '{"page":1,"limit":1}' --json

Provider shortcut

kosmo integrations:ko-fi ko-fi_list_shop_items '{"page":1,"limit":1}' --json

`ko-fi.ko-fi_get_current_user`

Read read

Get the profile of the currently authenticated Ko-fi user. Useful to verify the connection and see account details.

Parameters: none

Generic CLI call

kosmo integrations:call ko-fi.ko-fi_get_current_user '{}' --json

Provider shortcut

kosmo integrations:ko-fi ko-fi_get_current_user '{}' --json

Function Schemas

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

`ko-fi.ko-fi_list_supporters`

List all supporters who have donated or subscribed to your Ko-fi page. Returns supporter names, emails, and contribution history.

Operation: Read read
Schema command: kosmo integrations:schema ko-fi.ko-fi_list_supporters --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).
`limit`	integer	no	Number of results per page (default: 25).

`ko-fi.ko-fi_get_supporter`

Get detailed information about a single Ko-fi supporter by their email address. Returns full supporter profile including contribution history and status.

Operation: Read read
Schema command: kosmo integrations:schema ko-fi.ko-fi_get_supporter --json

Parameter	Type	Required	Description
`email`	string	yes	The email address of the supporter to retrieve.

`ko-fi.ko-fi_list_transactions`

List all transactions on your Ko-fi page including donations, subscriptions, and shop orders. Returns transaction details with amounts and dates.

Operation: Read read
Schema command: kosmo integrations:schema ko-fi.ko-fi_list_transactions --json

Parameter	Type	Required	Description
`type`	string	no	Filter by transaction type: donation, subscription, or shop_order.
`page`	integer	no	Page number for pagination (default: 1).
`limit`	integer	no	Number of results per page (default: 25).

`ko-fi.ko-fi_list_commissions`

List all commission requests on your Ko-fi page. Returns commission details including status, requester info, and pricing.

Operation: Read read
Schema command: kosmo integrations:schema ko-fi.ko-fi_list_commissions --json

Parameter	Type	Required	Description
`status`	string	no	Filter by commission status: pending, accepted, completed, or declined.
`page`	integer	no	Page number for pagination (default: 1).
`limit`	integer	no	Number of results per page (default: 25).

`ko-fi.ko-fi_get_commission`

Get detailed information about a single Ko-fi commission by its ID. Returns full commission data including description, status, and requester details.

Operation: Read read
Schema command: kosmo integrations:schema ko-fi.ko-fi_get_commission --json

Parameter	Type	Required	Description
`commission_id`	string	yes	The ID of the commission to retrieve.

`ko-fi.ko-fi_list_shop_items`

List all items in your Ko-fi shop. Returns item names, descriptions, prices, and availability.

Operation: Read read
Schema command: kosmo integrations:schema ko-fi.ko-fi_list_shop_items --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).
`limit`	integer	no	Number of results per page (default: 25).

`ko-fi.ko-fi_get_current_user`

Get the profile of the currently authenticated Ko-fi user. Useful to verify the connection and see account details.

Operation: Read read
Schema command: kosmo integrations:schema ko-fi.ko-fi_get_current_user --json

Parameter	Type	Required	Description
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.