# Mollie MCP

> Mollie connects your merchant account directly to your AI agent. Track every payment, manage e-commerce orders, and handle customer accounts all through natural conversation. You get full visibility into payments, refunds, chargebacks, and order details without ever leaving your chat interface.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** merchant-services, transaction-tracking, order-management, payment-gateway, e-commerce-finance

## Description

You can control your entire e-commerce financial workflow right from your chat client. Instead of logging into the Mollie dashboard to check statuses or run reports, you simply ask your agent a question—like 'What are my most recent payments?'—and get a detailed answer instantly. This MCP lets you manage orders, view customer profiles, and even create new payment links on demand. Whether you need to verify an order's fulfillment status or pull a list of refunds for reconciliation, it handles the complexity so you don't have to click through endless tabs. All this power is available by connecting your agent through Vinkius, giving you one place to manage critical financial data.

## Tools

### create_payment
Generates a new Mollie payment link with specific details.

### get_customer
Retrieves all stored information for a specific customer ID.

### get_order
Fetches line items and shipping status for one specific order.

### get_payment
Gets full transaction details using a unique payment ID.

### get_refund
Retrieves all records and status updates for a specific refund.

### list_chargebacks
Provides a list of payments that have been disputed or charged back.

### list_customers
Returns a comprehensive list of all customers associated with your account.

### list_orders
Lists every e-commerce order currently recorded in the system.

### list_payments
Provides a list of all payments processed through Mollie, including status and amount.

### list_refunds
Generates a full list of all refunds that have been issued or processed.

## Prompt Examples

**Prompt:** 
```
List my 5 most recent payments and their current status.
```

**Response:** 
```
I've retrieved your recent transactions. You have 5 recent payments: three are 'paid' (totaling €150.00), one is 'open' (waiting for payment), and one is 'expired'. Would you like more details on the open payment?
```

**Prompt:** 
```
Create a new payment link for €45.00 for 'Service Invoice #123'.
```

**Response:** 
```
I've generated the payment link for 'Service Invoice #123'. The amount is €45.00 and you can send this URL to your customer: https://www.mollie.com/checkout/select-method/7PrMmS. The payment is currently in 'open' status.
```

**Prompt:** 
```
Show me my refund history.
```

**Response:** 
```
Retrieving your refunds... You have processed 3 refunds recently: two for 'Service Refund' (€20.00 each) and one for 'Returned Product' (€55.00). All are marked as 'succeeded'.
```

## Capabilities

### Check and track payments
View real-time transaction statuses, amounts, and full metadata for any payment.

### Manage e-commerce orders
Retrieve detailed information about specific sales or list all recent orders and their fulfillment status.

### Handle refunds and disputes
Review refund history, monitor chargebacks, and get details on disputed payments.

### Access customer records
Retrieve specific customer profiles, including their payment history and saved details.

### Generate payment links
Create new, custom payment links with specific amounts and currencies for invoicing.

## Use Cases

### Verifying a missing payment
A client calls saying they paid but their order isn't updating. Instead of asking the client for tracking IDs, your agent uses get_payment to instantly confirm if the transaction is 'paid' or 'open', solving the issue in seconds.

### Year-end financial audit
The finance team needs a summary of all disputed funds. They ask for a list of chargebacks, and the agent runs list_chargebacks, providing a clean dataset to start their quarterly report immediately.

### Handling bulk customer data
A marketing manager wants to segment users based on activity. By running list_customers, they get access to key profile details and payment history for immediate analysis.

### Quick invoicing
You need to bill a client immediately for an extra service. You use create_payment, which generates the secure link instantly, allowing you to send it right away without navigating multiple forms.

## Benefits

- Get instant financial data. Instead of digging through the Mollie dashboard to see transaction details, you can ask your agent for a list of payments or check specific payment status using get_payment.
- Keep support streamlined. When assisting a customer, use get_order to instantly pull up fulfillment status and line items without needing them to manually provide order numbers.
- Simplify finance reporting. You no longer need to export multiple reports. Running the list_refunds or list_chargebacks tool gives you a complete overview of your dispute activity for reconciliation.
- Never lose track of clients. Listing all customers with list_customers means you always have access to key details, including their payment history and saved information.
- Process sales faster. Use create_payment when you need to generate an immediate link for an invoice, letting the customer pay directly without manual setup.

## How It Works

The bottom line is you manage complex e-commerce finances by simply talking to your agent.

1. Subscribe to this MCP and input your Mollie API Key (either Live or Test).
2. Connect the MCP in your preferred AI client, such as Cursor or Claude.
3. Ask your agent a natural language question, like 'List all orders from last week' to get instant financial data.

## Frequently Asked Questions

**How do I check if my payments are complete using the Mollie MCP?**
You use list_payments to see all transactions at once. If you need details on one specific payment, run get_payment and provide the unique ID for a full status breakdown.

**Can I create an invoice using the Mollie MCP?**
Yes, use create_payment. You just tell your agent the amount and description, and it generates the ready-to-send payment link immediately.

**What is the difference between list_orders and get_order in Mollie MCP?**
list_orders gives you a summary of all sales. If you know the specific order ID, use get_order to pull up every line item and fulfillment status for that single sale.

**How do I find out about disputed payments using Mollie MCP?**
You run list_chargebacks. This tool compiles a list of all payments that have been flagged or disputed, helping you track potential losses.

**Does the Mollie MCP handle customer data updates?**
While it doesn't update records for you, get_customer lets you retrieve the complete profile and payment history of any known user at a moment’s notice.