Can I use Buy Me a Coffee as a CLI?

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

Can I expose Buy Me a Coffee through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Buy Me a Coffee tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Buy Me a Coffee credentials stored?

Buy Me a Coffee credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Buy Me a Coffee MCP tools?

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

productivity

Buy Me a Coffee CLI for AI Agents

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

Buy Me a Coffee CLI Setup

Buy Me a Coffee can be configured headlessly with `kosmokrator integrations:configure buymeacoffee`.

Install, configure, and verify

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

Credentials

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

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

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call buymeacoffee.buymeacoffee_list_supporters '{"page":1}' --json

Provider shortcut

kosmo integrations:buymeacoffee buymeacoffee_list_supporters '{"page":1}' --json

Discovery

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

Discovery commands

kosmo integrations:docs buymeacoffee --json
kosmo integrations:docs buymeacoffee.buymeacoffee_list_supporters --json
kosmo integrations:schema buymeacoffee.buymeacoffee_list_supporters --json
kosmo integrations:search "Buy Me a Coffee" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`buymeacoffee.buymeacoffee_list_supporters`

List all supporters in your Buy Me a Coffee account. Returns supporter names, emails, support amounts, and dates.

Read read

Parameters: page

Generic call

kosmo integrations:call buymeacoffee.buymeacoffee_list_supporters '{"page":1}' --json

Shortcut

kosmo integrations:buymeacoffee buymeacoffee_list_supporters '{"page":1}' --json

`buymeacoffee.buymeacoffee_get_supporter`

Get detailed information about a single Buy Me a Coffee supporter by their ID. Returns full supporter data including support history and notes.

Read read

Parameters: supporter_id

Generic call

kosmo integrations:call buymeacoffee.buymeacoffee_get_supporter '{"supporter_id":"example_supporter_id"}' --json

Shortcut

kosmo integrations:buymeacoffee buymeacoffee_get_supporter '{"supporter_id":"example_supporter_id"}' --json

`buymeacoffee.buymeacoffee_list_subscriptions`

List all active recurring subscriptions in your Buy Me a Coffee account. Returns subscriber details, amounts, and status.

Read read

Parameters: page

Generic call

kosmo integrations:call buymeacoffee.buymeacoffee_list_subscriptions '{"page":1}' --json

Shortcut

kosmo integrations:buymeacoffee buymeacoffee_list_subscriptions '{"page":1}' --json

`buymeacoffee.buymeacoffee_list_extras`

List all extras (additional purchase options) in your Buy Me a Coffee account. Returns extra names, descriptions, and pricing.

Read read

Parameters: page

Generic call

kosmo integrations:call buymeacoffee.buymeacoffee_list_extras '{"page":1}' --json

Shortcut

kosmo integrations:buymeacoffee buymeacoffee_list_extras '{"page":1}' --json

`buymeacoffee.buymeacoffee_get_extra`

Get detailed information about a single Buy Me a Coffee extra by its ID. Returns full extra data including description, pricing, and purchase count.

Read read

Parameters: extra_id

Generic call

kosmo integrations:call buymeacoffee.buymeacoffee_get_extra '{"extra_id":"example_extra_id"}' --json

Shortcut

kosmo integrations:buymeacoffee buymeacoffee_get_extra '{"extra_id":"example_extra_id"}' --json

`buymeacoffee.buymeacoffee_list_shops`

List all shop items in your Buy Me a Coffee account. Returns shop item names, descriptions, prices, and availability.

Read read

Parameters: page

Generic call

kosmo integrations:call buymeacoffee.buymeacoffee_list_shops '{"page":1}' --json

Shortcut

kosmo integrations:buymeacoffee buymeacoffee_list_shops '{"page":1}' --json

`buymeacoffee.buymeacoffee_get_current_user`

Get the profile of the currently authenticated Buy Me a Coffee user. Useful to verify the connection and see account details.

Read read

Parameters: none

Generic call

kosmo integrations:call buymeacoffee.buymeacoffee_get_current_user '{}' --json

Shortcut

kosmo integrations:buymeacoffee buymeacoffee_get_current_user '{}' --json

Function Schemas

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

buymeacoffee.buymeacoffee_list_supporters 1 parameters

Schema command

kosmo integrations:schema buymeacoffee.buymeacoffee_list_supporters --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).

buymeacoffee.buymeacoffee_get_supporter 1 parameters

Schema command

kosmo integrations:schema buymeacoffee.buymeacoffee_get_supporter --json

Parameter	Type	Required	Description
`supporter_id`	string	yes	The ID of the supporter to retrieve.

buymeacoffee.buymeacoffee_list_subscriptions 1 parameters

Schema command

kosmo integrations:schema buymeacoffee.buymeacoffee_list_subscriptions --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).

buymeacoffee.buymeacoffee_list_extras 1 parameters

Schema command

kosmo integrations:schema buymeacoffee.buymeacoffee_list_extras --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).

buymeacoffee.buymeacoffee_get_extra 1 parameters

Schema command

kosmo integrations:schema buymeacoffee.buymeacoffee_get_extra --json

Parameter	Type	Required	Description
`extra_id`	string	yes	The ID of the extra to retrieve.

buymeacoffee.buymeacoffee_list_shops 1 parameters

Schema command

kosmo integrations:schema buymeacoffee.buymeacoffee_list_shops --json

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).

buymeacoffee.buymeacoffee_get_current_user 0 parameters

Schema command

kosmo integrations:schema buymeacoffee.buymeacoffee_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.