Can I use Gumroad as a CLI?

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

Can I expose Gumroad through MCP?

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

Where are Gumroad credentials stored?

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

Can I deny write access for Gumroad MCP tools?

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

productivity

Gumroad CLI for AI Agents

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

Gumroad CLI Setup

Gumroad can be configured headlessly with `kosmokrator integrations:configure gumroad`.

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 gumroad --set access_token="$GUMROAD_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor gumroad --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`	`GUMROAD_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`GUMROAD_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 gumroad.gumroad_api_get '{}' --json

Provider shortcut

kosmo integrations:gumroad gumroad_api_get '{}' --json

Discovery

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

Discovery commands

kosmo integrations:docs gumroad --json
kosmo integrations:docs gumroad.gumroad_api_get --json
kosmo integrations:schema gumroad.gumroad_api_get --json
kosmo integrations:search "Gumroad" --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.

`gumroad.gumroad_api_get`

Call any Gumroad API v2 GET endpoint path.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_api_get '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_api_get '{}' --json

`gumroad.gumroad_api_post`

Call any Gumroad API v2 POST endpoint path.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_api_post '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_api_post '{}' --json

`gumroad.gumroad_api_put`

Call any Gumroad API v2 PUT endpoint path.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_api_put '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_api_put '{}' --json

`gumroad.gumroad_api_delete`

Call any Gumroad API v2 DELETE endpoint path.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_api_delete '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_api_delete '{}' --json

`gumroad.gumroad_get_current_user`

Get the authenticated Gumroad user profile.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_get_current_user '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_get_current_user '{}' --json

`gumroad.gumroad_list_products`

List all Gumroad products for the authenticated account.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_list_products '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_list_products '{}' --json

`gumroad.gumroad_get_product`

Get one Gumroad product by ID.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_get_product '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_get_product '{}' --json

`gumroad.gumroad_list_product_custom_fields`

List custom fields for a product.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_list_product_custom_fields '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_list_product_custom_fields '{}' --json

`gumroad.gumroad_list_product_variants`

List variants for a product.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_list_product_variants '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_list_product_variants '{}' --json

`gumroad.gumroad_list_product_offer_codes`

List offer codes for a product.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_list_product_offer_codes '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_list_product_offer_codes '{}' --json

`gumroad.gumroad_create_product_offer_code`

Create an offer code for a product.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_create_product_offer_code '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_create_product_offer_code '{}' --json

`gumroad.gumroad_delete_product_offer_code`

Delete an offer code for a product.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_delete_product_offer_code '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_delete_product_offer_code '{}' --json

`gumroad.gumroad_list_sales`

List successful sales with optional filters.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_list_sales '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_list_sales '{}' --json

`gumroad.gumroad_get_sale`

Get one sale by ID.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_get_sale '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_get_sale '{}' --json

`gumroad.gumroad_mark_sale_as_shipped`

Mark a physical sale as shipped.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_mark_sale_as_shipped '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_mark_sale_as_shipped '{}' --json

`gumroad.gumroad_refund_sale`

Refund a sale.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_refund_sale '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_refund_sale '{}' --json

`gumroad.gumroad_list_subscribers`

List subscribers, optionally filtered by product.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_list_subscribers '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_list_subscribers '{}' --json

`gumroad.gumroad_get_subscriber`

Get one subscriber by ID.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_get_subscriber '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_get_subscriber '{}' --json

`gumroad.gumroad_list_product_subscribers`

List subscribers for a specific product.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_list_product_subscribers '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_list_product_subscribers '{}' --json

`gumroad.gumroad_list_offers`

List account-level offers when available.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_list_offers '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_list_offers '{}' --json

`gumroad.gumroad_verify_license`

Verify a Gumroad license key.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_verify_license '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_verify_license '{}' --json

`gumroad.gumroad_enable_license`

Enable a Gumroad license key.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_enable_license '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_enable_license '{}' --json

`gumroad.gumroad_disable_license`

Disable a Gumroad license key.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_disable_license '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_disable_license '{}' --json

`gumroad.gumroad_decrement_license_uses`

Decrement the uses count for a Gumroad license key.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_decrement_license_uses '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_decrement_license_uses '{}' --json

`gumroad.gumroad_list_resource_subscriptions`

List webhook resource subscriptions by resource name.

Read read

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_list_resource_subscriptions '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_list_resource_subscriptions '{}' --json

`gumroad.gumroad_create_resource_subscription`

Subscribe a URL to Gumroad resource notifications.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_create_resource_subscription '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_create_resource_subscription '{}' --json

`gumroad.gumroad_delete_resource_subscription`

Delete a Gumroad resource subscription.

Write write

Parameters: none

Generic call

kosmo integrations:call gumroad.gumroad_delete_resource_subscription '{}' --json

Shortcut

kosmo integrations:gumroad gumroad_delete_resource_subscription '{}' --json

Function Schemas

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

gumroad.gumroad_api_get 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_api_get --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_api_post 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_api_post --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_api_put 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_api_put --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_api_delete 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_api_delete --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_get_current_user 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_get_current_user --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_list_products 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_list_products --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_get_product 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_get_product --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_list_product_custom_fields 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_list_product_custom_fields --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_list_product_variants 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_list_product_variants --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_list_product_offer_codes 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_list_product_offer_codes --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_create_product_offer_code 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_create_product_offer_code --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_delete_product_offer_code 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_delete_product_offer_code --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_list_sales 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_list_sales --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_get_sale 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_get_sale --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_mark_sale_as_shipped 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_mark_sale_as_shipped --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_refund_sale 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_refund_sale --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_list_subscribers 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_list_subscribers --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_get_subscriber 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_get_subscriber --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_list_product_subscribers 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_list_product_subscribers --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_list_offers 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_list_offers --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_verify_license 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_verify_license --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_enable_license 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_enable_license --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_disable_license 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_disable_license --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_decrement_license_uses 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_decrement_license_uses --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_list_resource_subscriptions 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_list_resource_subscriptions --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_create_resource_subscription 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_create_resource_subscription --json

Parameter	Type	Required	Description
No parameters.

gumroad.gumroad_delete_resource_subscription 0 parameters

Schema command

kosmo integrations:schema gumroad.gumroad_delete_resource_subscription --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.