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.

ecommerce

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.

7 functions 7 read 0 write Bearer token auth

Submit Gumroad feedback View package source

Gumroad CLI Setup

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

# 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 use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

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

Call Gumroad Headlessly

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

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

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

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

Agent Discovery Commands

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

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

`gumroad.gumroad_list_products`

Read read

List all digital products in your Gumroad account. Returns product names, IDs, prices, and metadata.

Parameters: none

Generic CLI call

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

Provider shortcut

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

`gumroad.gumroad_get_product`

Read read

Get detailed information about a single Gumroad product by its ID. Returns full product data including description, price, variants, and purchase URL.

Parameters: product_id

Generic CLI call

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

Provider shortcut

kosmo integrations:gumroad gumroad_get_product '{"product_id":"example_product_id"}' --json

`gumroad.gumroad_list_sales`

Read read

List sales from your Gumroad account. Optionally filter by product ID, date range, or page. Returns sale details including buyer info, amount, and product.

Parameters: product_id, before, after, page

Generic CLI call

kosmo integrations:call gumroad.gumroad_list_sales '{"product_id":"example_product_id","before":"example_before","after":"example_after","page":1}' --json

Provider shortcut

kosmo integrations:gumroad gumroad_list_sales '{"product_id":"example_product_id","before":"example_before","after":"example_after","page":1}' --json

`gumroad.gumroad_list_subscribers`

Read read

List all subscribers in your Gumroad account. Optionally filter by product ID to get subscribers for a specific membership or product.

Parameters: product_id, page

Generic CLI call

kosmo integrations:call gumroad.gumroad_list_subscribers '{"product_id":"example_product_id","page":1}' --json

Provider shortcut

kosmo integrations:gumroad gumroad_list_subscribers '{"product_id":"example_product_id","page":1}' --json

`gumroad.gumroad_get_subscriber`

Read read

Get detailed information about a single Gumroad subscriber by their ID. Returns subscriber status, email, and subscription details.

Parameters: subscriber_id

Generic CLI call

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

Provider shortcut

kosmo integrations:gumroad gumroad_get_subscriber '{"subscriber_id":"example_subscriber_id"}' --json

`gumroad.gumroad_list_offers`

Read read

List all offers (discount codes) in your Gumroad account. Returns offer codes, discount amounts, and associated products.

Parameters: none

Generic CLI call

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

Provider shortcut

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

`gumroad.gumroad_get_current_user`

Read read

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

Parameters: none

Generic CLI call

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

Provider shortcut

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

Function Schemas

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

`gumroad.gumroad_list_products`

List all digital products in your Gumroad account. Returns product names, IDs, prices, and metadata.

Operation: Read read
Schema command: kosmo integrations:schema gumroad.gumroad_list_products --json

Parameter	Type	Required	Description
No parameters.

`gumroad.gumroad_get_product`

Get detailed information about a single Gumroad product by its ID. Returns full product data including description, price, variants, and purchase URL.

Operation: Read read
Schema command: kosmo integrations:schema gumroad.gumroad_get_product --json

Parameter	Type	Required	Description
`product_id`	string	yes	The ID of the product to retrieve.

`gumroad.gumroad_list_sales`

List sales from your Gumroad account. Optionally filter by product ID, date range, or page. Returns sale details including buyer info, amount, and product.

Operation: Read read
Schema command: kosmo integrations:schema gumroad.gumroad_list_sales --json

Parameter	Type	Required	Description
`product_id`	string	no	Filter sales by a specific product ID.
`before`	string	no	Only return sales before this ISO 8601 timestamp (e.g., "2026-01-01T00:00:00Z").
`after`	string	no	Only return sales after this ISO 8601 timestamp (e.g., "2026-01-01T00:00:00Z").
`page`	integer	no	Page number for pagination (default: 1).

`gumroad.gumroad_list_subscribers`

List all subscribers in your Gumroad account. Optionally filter by product ID to get subscribers for a specific membership or product.

Operation: Read read
Schema command: kosmo integrations:schema gumroad.gumroad_list_subscribers --json

Parameter	Type	Required	Description
`product_id`	string	no	Filter subscribers by a specific product ID (e.g., a membership product).
`page`	integer	no	Page number for pagination (default: 1).

`gumroad.gumroad_get_subscriber`

Get detailed information about a single Gumroad subscriber by their ID. Returns subscriber status, email, and subscription details.

Operation: Read read
Schema command: kosmo integrations:schema gumroad.gumroad_get_subscriber --json

Parameter	Type	Required	Description
`subscriber_id`	string	yes	The ID of the subscriber to retrieve.

`gumroad.gumroad_list_offers`

List all offers (discount codes) in your Gumroad account. Returns offer codes, discount amounts, and associated products.

Operation: Read read
Schema command: kosmo integrations:schema gumroad.gumroad_list_offers --json

Parameter	Type	Required	Description
No parameters.

`gumroad.gumroad_get_current_user`

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

Operation: Read read
Schema command: kosmo integrations:schema gumroad.gumroad_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.