stackgate.ai
All integrations

Mollie

Connect Claude, ChatGPT or Cursor to Mollie via MCP. Read payments, refunds, settlements, balances, and payment methods with an API key.

Manual setup 7 tools

Example questions

Try asking your AI client

  • Which Mollie payments failed or are pending from the last 2 days?

  • Did the refund to Jack ever settle?

  • Summarize settlements and available balance this week.

  • Write a short payments brief for Amalie - do not create a payment.

  • Which methods are converting worst in Denmark right now?

Overview

Connect Mollie so AI clients can read payments, refunds, settlements, balances, and enabled payment methods via the Mollie Payments API.

This integration is read-first: list and get tools only. Creating payments or issuing refunds is not included.

Prerequisites

  • A Mollie account with a website profile
  • Permission to view Developers → API keys (account owner or admin)
  • A stackgate.ai account

Getting credentials

  1. Sign in to the Mollie Dashboard for the merchant you want to connect.
  2. Open Developers → API keys.
  3. Copy a test_ key for sandbox work or a live_ key for production. Each key is already scoped to one website profile.
  4. In stackgate.ai, open My Integrations → Mollie.
  5. Paste the API key and save. stackgate.ai verifies the key against Mollie's /methods endpoint and stores whether it is test or live.
  6. Optionally use Edit tool access to keep the connection read-only.

See Mollie authentication and the Payments API.

Organization access tokens can also be pasted if you need settlements or balances. Website profile keys already target one profile, so extra profile selection is not required.

Using with AI clients

  • Dedicated endpoint: POST /mcp/mollie with a Sanctum bearer token
  • Private gateway: one config for all integrations - use mollie__* namespaced tools

Example prompts:

  • "List my recent Mollie payments."
  • "Get Mollie payment tr_WDqYK6vllg."
  • "Show refunds for that payment."
  • "Which payment methods are enabled on this Mollie profile?"

Troubleshooting

  • 422 integration not configured - complete the API key form in My Integrations.
  • 401 Unauthorized - regenerate the API key in the Mollie Dashboard and update My Integrations.
  • Invalid key prefix - keys must start with test_ or live_.
  • 403 on settlements or balances - those endpoints often need an organization access token, not a website profile key.
  • 429 Too many requests - Mollie rate-limits burst traffic. Retry after a short delay.

Security and revocation

Disconnect Mollie in My Integrations to delete the stored key from stackgate.ai. Also revoke or rotate the key under Developers → API keys in the Mollie Dashboard.

Limitations

  • Read-only MVP: no create payment, capture, cancel, or refund tools.
  • Settlements and primary balance may be unavailable on website profile API keys.
  • Webhook ingestion is not included. Poll get_payment for status updates.

Available tools

  • list_payments

    List Mollie payments for the connected profile, newest first by default.

  • get_payment

    Get a Mollie payment by ID, including status, amount, method, and metadata.

  • list_refunds

    List Mollie refunds. Pass payment_id to list refunds for one payment, otherwise list profile refunds.

  • get_refund

    Get a Mollie refund by payment ID and refund ID.

  • list_settlements

    List Mollie settlements (payout batches). May require organization-level API access.

  • get_balance

    Get the primary Mollie balance (available and pending amounts). May require organization-level API access.

  • list_methods

    List payment methods enabled for the connected Mollie profile.

MCP endpoint: https://stackgate.ai/mcp/mollie (HTTP) or via the private gateway.

Create account Documentation