At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
MOLLIE_API_KEYis sent as theBearerprefixedAuthorizationheader. - Docs: https://docs.mollie.com/reference/authentication
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
MOLLIE_API_KEY | Yes | Mollie API key (starts with live_ for production or test_ for test mode) Docs. |
Setup
- Create a Mollie account: Sign up at https://www.mollie.com. You can use test mode immediately after signup, before your account is fully activated for live payments.
- Get your API key: In the Mollie Dashboard, go to Developers > API keys. Each website profile has a paired test key (test_…) and live key (live_…). Copy the key right away; treat it as a secret.
- Configure the environment variable: Set MOLLIE_API_KEY to your test_ key while developing. Payments made with a test_ key are simulated and never charge real money. Switch to your live_ key once your account is approved for live payments.
- Test mode and live mode are selected by the key prefix: test_ keys hit the same https://api.mollie.com/v2 endpoints but operate on simulated data.
- Amounts are strings with the exact number of decimals for the currency, e.g. “10.00” for EUR.
- Set a webhookUrl on payments in production so you receive status changes; polling get_payment also works for agent workflows.
Tools
| Tool | Access | Description |
|---|---|---|
| List Payments | Read | List Mollie payments in reverse chronological order to review recent transactions |
| Get Payment | Read | Retrieve a single Mollie payment with its current status and details |
| Create Payment | Write | Create a Mollie payment and get a checkout URL to send to the customer |
| List Customers | Read | List Mollie customers to find customer IDs for payments or refund context |
| List Payment Methods | Read | List the payment methods enabled on your Mollie profile, e.g. to pick a valid method for a new payment |
| Create Payment Link | Write | Create a shareable hosted payment link the customer can open to pay, without building a checkout |
| List Payment Refunds | Read | List the refunds created for a payment to review refund status and history |
| Create Refund | Write | Refund all or part of a Mollie payment back to the customer |
Example prompts
- List my most recent Mollie payments and summarize their statuses and amounts.
- Look up a Mollie payment by ID and tell me its current status, amount, and method.
- Refund a Mollie payment: confirm the payment details with me first, then create the refund.