Can I use Mollie as a CLI?

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

Can I expose Mollie through MCP?

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

Where are Mollie credentials stored?

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

Can I deny write access for Mollie MCP tools?

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

data

Mollie CLI for AI Agents

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

Mollie CLI Setup

Mollie can be configured headlessly with `kosmokrator integrations:configure mollie`.

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 mollie --set access_token="$MOLLIE_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor mollie --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`	`MOLLIE_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`MOLLIE_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 mollie.mollie_list_payments '{"limit":1,"from":"example_from","profileId":"example_profileId"}' --json

Provider shortcut

kosmo integrations:mollie mollie_list_payments '{"limit":1,"from":"example_from","profileId":"example_profileId"}' --json

Discovery

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

Discovery commands

kosmo integrations:docs mollie --json
kosmo integrations:docs mollie.mollie_list_payments --json
kosmo integrations:schema mollie.mollie_list_payments --json
kosmo integrations:search "Mollie" --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.

`mollie.mollie_list_payments`

List payments from Mollie. Returns payment resources with status, amount, and metadata. Use filters like profileId to narrow results.

Read read

Parameters: limit, from, profileId

Generic call

kosmo integrations:call mollie.mollie_list_payments '{"limit":1,"from":"example_from","profileId":"example_profileId"}' --json

Shortcut

kosmo integrations:mollie mollie_list_payments '{"limit":1,"from":"example_from","profileId":"example_profileId"}' --json

`mollie.mollie_get_payment`

Retrieve a single Mollie payment by its ID. Returns the full payment resource with status, amount, and checkout links.

Read read

Parameters: id

Generic call

kosmo integrations:call mollie.mollie_get_payment '{"id":"example_id"}' --json

Shortcut

kosmo integrations:mollie mollie_get_payment '{"id":"example_id"}' --json

`mollie.mollie_create_payment`

Create a new Mollie payment. Requires amount (currency and value), description, and a redirectUrl. Returns the payment resource with a checkout link.

Write write

Parameters: amount, description, redirectUrl, metadata, method, locale

Generic call

kosmo integrations:call mollie.mollie_create_payment '{"amount":"example_amount","description":"example_description","redirectUrl":"example_redirectUrl","metadata":"example_metadata","method":"example_method","locale":"example_locale"}' --json

Shortcut

kosmo integrations:mollie mollie_create_payment '{"amount":"example_amount","description":"example_description","redirectUrl":"example_redirectUrl","metadata":"example_metadata","method":"example_method","locale":"example_locale"}' --json

`mollie.mollie_list_customers`

List all customers from Mollie. Returns customer resources with name, email, and metadata.

Read read

Parameters: limit, from

Generic call

kosmo integrations:call mollie.mollie_list_customers '{"limit":1,"from":"example_from"}' --json

Shortcut

kosmo integrations:mollie mollie_list_customers '{"limit":1,"from":"example_from"}' --json

`mollie.mollie_create_customer`

Create a new Mollie customer. Requires name and email. Returns the customer resource with an ID for creating subscriptions.

Write write

Parameters: name, email, locale, metadata

Generic call

kosmo integrations:call mollie.mollie_create_customer '{"name":"example_name","email":"example_email","locale":"example_locale","metadata":"example_metadata"}' --json

Shortcut

kosmo integrations:mollie mollie_create_customer '{"name":"example_name","email":"example_email","locale":"example_locale","metadata":"example_metadata"}' --json

`mollie.mollie_list_subscriptions`

List all subscriptions for a specific Mollie customer. Requires a customer ID (e.g., "cst_abc123"). Returns subscription resources with status, amount, and interval.

Read read

Parameters: customer_id, limit, from

Generic call

kosmo integrations:call mollie.mollie_list_subscriptions '{"customer_id":"example_customer_id","limit":1,"from":"example_from"}' --json

Shortcut

kosmo integrations:mollie mollie_list_subscriptions '{"customer_id":"example_customer_id","limit":1,"from":"example_from"}' --json

`mollie.mollie_create_subscription`

Create a subscription for a Mollie customer. Requires customer ID, amount (currency and value), interval (e.g., "1 month"), and description.

Write write

Parameters: customer_id, amount, interval, description, method, webhookUrl, metadata, startDate, times

Generic call

kosmo integrations:call mollie.mollie_create_subscription '{"customer_id":"example_customer_id","amount":"example_amount","interval":"example_interval","description":"example_description","method":"example_method","webhookUrl":"example_webhookUrl","metadata":"example_metadata","startDate":"example_startDate"}' --json

Shortcut

kosmo integrations:mollie mollie_create_subscription '{"customer_id":"example_customer_id","amount":"example_amount","interval":"example_interval","description":"example_description","method":"example_method","webhookUrl":"example_webhookUrl","metadata":"example_metadata","startDate":"example_startDate"}' --json

`mollie.mollie_list_invoices`

List invoices for the authenticated Mollie account. Supports filtering by year, month, and reference.

Read read

Parameters: limit, from, reference, year, month

Generic call

kosmo integrations:call mollie.mollie_list_invoices '{"limit":1,"from":"example_from","reference":"example_reference","year":1,"month":1}' --json

Shortcut

kosmo integrations:mollie mollie_list_invoices '{"limit":1,"from":"example_from","reference":"example_reference","year":1,"month":1}' --json

`mollie.mollie_get_current_user`

Retrieve the enabled payment methods for the authenticated Mollie account. Returns a list of available payment methods (e.g., iDEAL, credit card, PayPal).

Read read

Parameters: none

Generic call

kosmo integrations:call mollie.mollie_get_current_user '{}' --json

Shortcut

kosmo integrations:mollie mollie_get_current_user '{}' --json

Function Schemas

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

mollie.mollie_list_payments 3 parameters

Schema command

kosmo integrations:schema mollie.mollie_list_payments --json

Parameter	Type	Required	Description
`limit`	integer	no	Number of payments to return (default: 50, max: 250).
`from`	string	no	Payment ID to start from for pagination.
`profileId`	string	no	Filter by profile ID.

mollie.mollie_get_payment 1 parameters

Schema command

kosmo integrations:schema mollie.mollie_get_payment --json

Parameter	Type	Required	Description
`id`	string	yes	The payment ID (e.g., "tr_abc123").

mollie.mollie_create_payment 6 parameters

Schema command

kosmo integrations:schema mollie.mollie_create_payment --json

Parameter	Type	Required	Description
`amount`	object	yes	Amount object with "currency" (e.g., "EUR") and "value" (e.g., "10.00").
`description`	string	yes	Description shown to the customer (e.g., "Order #123").
`redirectUrl`	string	yes	URL to redirect the customer to after payment completion.
`metadata`	object	no	Custom metadata to attach to the payment.
`method`	string	no	Payment method (e.g., "ideal", "creditcard", "paypal").
`locale`	string	no	Locale for the payment screen (e.g., "nl_NL", "en_US").

mollie.mollie_list_customers 2 parameters

Schema command

kosmo integrations:schema mollie.mollie_list_customers --json

Parameter	Type	Required	Description
`limit`	integer	no	Number of customers to return (default: 50, max: 250).
`from`	string	no	Customer ID to start from for pagination.

mollie.mollie_create_customer 4 parameters

Schema command

kosmo integrations:schema mollie.mollie_create_customer --json

Parameter	Type	Required	Description
`name`	string	yes	Full name of the customer.
`email`	string	yes	Email address of the customer.
`locale`	string	no	Preferred locale (e.g., "nl_NL", "en_US").
`metadata`	object	no	Custom metadata to attach to the customer.

mollie.mollie_list_subscriptions 3 parameters

Schema command

kosmo integrations:schema mollie.mollie_list_subscriptions --json

Parameter	Type	Required	Description
`customer_id`	string	yes	The customer ID (e.g., "cst_abc123").
`limit`	integer	no	Number of subscriptions to return (default: 50, max: 250).
`from`	string	no	Subscription ID to start from for pagination.

mollie.mollie_create_subscription 9 parameters

Schema command

kosmo integrations:schema mollie.mollie_create_subscription --json

Parameter	Type	Required	Description
`customer_id`	string	yes	The customer ID (e.g., "cst_abc123").
`amount`	object	yes	Amount object with "currency" (e.g., "EUR") and "value" (e.g., "9.99").
`interval`	string	yes	Billing interval (e.g., "1 month", "1 year", "2 weeks").
`description`	string	yes	Description of the subscription shown to the customer.
`method`	string	no	Payment method (e.g., "ideal", "creditcard").
`webhookUrl`	string	no	URL to receive webhook notifications for subscription events.
`metadata`	object	no	Custom metadata to attach to the subscription.
`startDate`	string	no	Start date for the subscription (ISO 8601, e.g., "2026-05-01").
`times`	integer	no	Number of billing cycles. Omit for indefinite.

mollie.mollie_list_invoices 5 parameters

Schema command

kosmo integrations:schema mollie.mollie_list_invoices --json

Parameter	Type	Required	Description
`limit`	integer	no	Number of invoices to return (default: 50, max: 250).
`from`	string	no	Invoice ID to start from for pagination.
`reference`	string	no	Filter by invoice reference.
`year`	integer	no	Filter by year (e.g., 2026).
`month`	integer	no	Filter by month (1-12).

mollie.mollie_get_current_user 0 parameters

Schema command

kosmo integrations:schema mollie.mollie_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.