# Mollie MCP

> Mollie MCP connects your AI agent directly to European payment processing. It lets you manage everything from creating new payments and tracking complex refunds to listing customer subscriptions—all through natural conversation. Handle iDEAL, Bancontact, credit cards, and local methods without opening a dashboard.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** payment-gateway, recurring-billing, refund-management, fintech, checkout, transaction-tracking

## Description

Manage all your European payments using just your voice or chat window. This MCP connects directly to your Mollie account, giving your AI client the power to perform complex financial operations typically reserved for developer dashboards. You can tell it to list recent transactions and get full status details on every payment. Need to process a refund? Your agent handles that too. Beyond payments, you can pull up customer lists or view which subscriptions are active for any user. All this happens without needing to copy an API key or navigate multiple web portals. Vinkius makes sure your AI client connects once and gets access to the full power of payment management in one place.

## Tools

### create_payment
Creates a new transaction for money to be paid by the customer.

### get_payment_details
Retrieves specific, granular details about one single payment ID.

### list_customers
Pulls a full list of all registered customers in the Mollie system.

### list_payment_methods
Shows which payment types (like iDEAL or PayPal) are currently enabled for use.

### list_payments
Generates a paginated list of all payments that have occurred.

### list_refunds
Lists every refund transaction processed in the system, helping with reconciliation.

### list_customer_subscriptions
Provides a list of all active and canceled recurring billing plans for one customer ID.

## Prompt Examples

**Prompt:** 
```
List recent payments and their statuses.
```

**Response:** 
```
Recent payments: 5. 1) €45.00 — 'Pro Plan Monthly' (Status: Paid ✅, iDEAL). 2) €120.00 — 'Annual License' (Status: Paid ✅, Credit Card). 3) €25.00 — 'Addon Purchase' (Status: Open ⏳). 4) €10.00 — 'Donation' (Status: Expired ❌). 5) €89.00 — 'Enterprise Upgrade' (Status: Paid ✅, Bancontact).
```

**Prompt:** 
```
Create a payment of €50 for a premium upgrade.
```

**Response:** 
```
Payment created! ✅ ID: tr_7UhSN1zuXS. Amount: €50.00. Description: 'Premium Upgrade'. Checkout URL: https://www.mollie.com/checkout/... Redirect URL: https://myapp.com/success. Status: Open. Waiting for customer to pay.
```

**Prompt:** 
```
Show enabled payment methods and list refunds.
```

**Response:** 
```
Enabled methods: 6. iDEAL ✅, Credit Card ✅, Bancontact ✅, PayPal ✅, SEPA Direct Debit ✅, Klarna ✅. Refunds (last 30 days): 3. 1) €12.00 (tr_abc, Refunded ✅). 2) €45.00 (tr_def, Processing). 3) €8.50 (tr_ghi, Refunded ✅).
```

## Capabilities

### Process payments
Initiate new transactions, specifying amounts and descriptions for immediate processing.

### Check transaction status
Retrieve full details on any payment, confirming its current state (e.g., paid, open, expired).

### List customer data
Pull a list of registered users to manage recurring billing cycles.

### Manage refunds
View all historical and pending refunds processed through the system.

### Track subscriptions
Get a detailed view of active or cancelled recurring billing plans for specific customers.

## Use Cases

### Handling failed payments
A user needs to know why a payment failed. They ask their agent to get_payment_details using the transaction ID, and the MCP returns the exact error code from Mollie.

### Processing annual renewals
The finance team runs into old customer records. They use list_customers to find a user, then call list_customer_subscriptions to see which plan is expiring, and finally create_payment for the renewal amount.

### Auditing refund trails
An auditor needs proof of all money returned last quarter. They ask the agent to list_refunds, getting a clean, paginated report they can use immediately.

### Checking payment method availability
A developer is building checkout logic for a new country and needs to know which local rails are ready. They run list_payment_methods to confirm iDEAL or Bancontact support.

## Benefits

- Automate reconciliation: Instead of digging through payment dashboards, use the list_refunds tool to quickly gather all refund data for month-end closing.
- Handle customer billing changes instantly: Use list_customer_subscriptions to check a user's plan status and then create_payment if an upgrade is needed.
- Cross-reference payments: You can list_payments to get general transaction volume, then use get_payment_details on specific IDs to find the exact failure point.
- Verify setup quickly: Need to know what payment options you support? The list_payment_methods tool shows all enabled methods (iDEAL, Bancontact, etc.) in seconds.
- Simplify customer onboarding: Start by listing_customers, then use create_payment to generate a trial or paid transaction for them.

## How It Works

The bottom line is you get financial operations done through conversation instead of clicking through dashboards.

1. Subscribe to this MCP and enter your Mollie API Key in the Vinkius platform.
2. Tell your AI client exactly what you need, like 'List all refunds from last month' or 'Create a payment for €75'.
3. Your agent calls the necessary tool, sends the data to Mollie, and returns the result—whether it's a list of customers or confirmation that a payment was created.

## Frequently Asked Questions

**How do I use Mollie MCP to check if a payment succeeded?**
Use get_payment_details with the specific transaction ID. This tool returns granular status information, letting you know exactly if the payment was paid, failed, or is still open.

**Can I list all available payment methods using Mollie MCP?**
Yes, calling list_payment_methods shows every enabled method your store accepts. This is useful for confirming local rails like iDEAL are active.

**What if a customer cancels their subscription? Can I see that with Mollie MCP?**
Use list_customer_subscriptions. It provides the history of billing plans, showing both active and cancelled status for any given user.

**Is Mollie MCP only for creating payments?**
No, it's much broader. You can also use tools like list_refunds to manage money that has already left your account for reconciliation purposes.