# Adyen MCP for AI Agents MCP

> Adyen connects your global payment ecosystem to your agent, letting you manage payments, handle refunds, and audit merchant accounts through natural conversation. Stop logging into multiple dashboards; simply ask your AI client for transaction status updates or account details, and get the answers immediately.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** global-payments, transaction-monitoring, refund-management, merchant-accounts, financial-orchestration, payment-gateway

## Description

Managing global payments used to mean jumping between several complex portals just to check on a single refund or verify an account setup. This MCP lets your agent handle that whole process using simple chat commands. You can track authorizations, initiate partial refunds, and audit merchant configurations without needing to know API keys or internal codes.

Whether you're an e-commerce manager checking checkout health or finance ops running end-of-day reconciliation, the connection handles it all. It gives your agent the ability to look up payment details for any PSP reference, list active accounts across regions, and verify necessary payment methods on demand. When you connect this MCP via Vinkius, your agent can process payments, manage refunds, and audit merchant account configurations through natural conversation.

## Tools

### get_payment_details
Retrieves all technical authorization and capture data for an Adyen payment based on its 16-digit PSP reference.

### refund_payment
Initiates a full or partial refund request for any previously captured payment in your Adyen account.

### list_merchants
Lists all active merchant accounts associated with your company profile across different regions (like US and EU).

### get_merchant_details
Retrieves the technical setup details and current status for a specific Adyen merchant account ID.

## Prompt Examples

**Prompt:** 
```
What happened with payment reference 8816123456789012?
```

**Response:** 
```
**Payment Status Report**

The transaction associated with `8816123456789012` was successfully **Captured** on March 30th for $50.00. It shows a high authorization rate and settled correctly.

*   **Status:** Captured
*   **Date:** 2024-03-30
*   **Amount:** $50.00

Would you like me to check the settlement details for this payment?
```

**Prompt:** 
```
I need to refund $15.00 for merchant ID EcomStore_US.
```

**Response:** 
```
**Refund Request Initiated**

Partial refund of **$15.00** has been requested for the specified merchant account. The request status is currently 'Received' by Adyen.

Please note: You will receive a webhook notification when this transaction processes fully.
```

**Prompt:** 
```
List all my active merchant accounts in both US and EU.
```

**Response:** 
```
**Active Merchant Accounts Found**

You have 3 operational accounts:

*   `EcomStore_US` (Status: Active)
*   `EcomStore_EU` (Status: Active)
*   `RetailPOS_UK` (Status: Suspended - Needs Review)

The `RetailPOS_UK` account is suspended. We should check its technical configuration details first.
```

## Capabilities

### Check specific transaction status
Retrieve the full technical details for an authorized or captured payment using a 16-digit reference number.

### Issue refunds and modify payments
Initiate partial or full refunds, directly managing previously captured funds via conversation with your agent.

### Audit associated merchant accounts
List all active company-linked merchant profiles across different regions (US, EU, etc.).

### Inspect account setup details
Retrieve the technical status and configuration for any specific merchant account you manage.

### Verify payment methods by region
Check which payment types are available in a given geographic area or currency pair.

## Use Cases

### Investigating a failed transaction
A customer support agent receives a call about an unexpected decline. They ask the agent to check the payment details using the PSP reference. The agent confirms the exact capture time and amount, allowing the agent to resolve the billing inquiry quickly.

### End-of-month reconciliation
A finance analyst needs to audit all accounts for a new partnership rollout. They ask the agent to list merchants, seeing all active account IDs across regions. This saves hours of manual dashboard checking before running reports.

### Processing a disputed chargeback
An e-commerce manager receives confirmation of a large dispute and needs to refund part of the original amount immediately. They ask the agent to initiate a partial refund, providing the necessary reference number in chat.

### Setting up international sales channels
A developer is launching services in a new region. Instead of reading technical docs, they ask the agent to verify payment methods for that specific country and currency pair before writing any code.

## Benefits

- Check status details instantly: Use the `get_payment_details` function to retrieve full metadata on any specific payment using its PSP reference.
- Automate dispute resolution: Instead of navigating refund menus, simply tell your agent to use `refund_payment` for partial or full refunds based on a reference number.
- Audit accounts quickly: Use `list_merchants` to see all active company profiles across regions. You don't have to manually compile that list in spreadsheets anymore.
- Verify compliance settings: Check specific account configurations and status using the `get_merchant_details` tool, ensuring every merchant setup is compliant.
- Resolve payment blockers on the fly: Verify if a required payment method is available for a client based on their geography or currency.

## How It Works

The bottom line is you get instant access to critical financial operations without ever having to navigate an internal web dashboard.

1. Subscribe to this MCP and provide your Adyen API Key and Merchant Account ID.
2. Connect the MCP to your preferred client, like Claude or Cursor.
3. Ask your agent a question, such as 'What is the status of payment X?' Your agent uses the connection to retrieve real-time data and gives you a plain language answer.

## Frequently Asked Questions

**How does the Adyen MCP help me track failed payments?**
It allows your agent to retrieve detailed metadata for any payment using a reference number. You get clear information on why it was refused or authorized, which is critical for customer support.

**Can I use the Adyen MCP to process refunds without logging in?**
Yes. By linking your account credentials, you can instruct your agent to initiate partial or full refunds directly through chat conversation. The system handles the necessary API calls for you.

**What kind of merchant accounts can I list with Adyen MCP?**
You can view all active company-linked merchant profiles across various regions (like US and EU). This gives you a single, consolidated view of your entire operational footprint.

**Do I need to worry about API keys when using the Adyen MCP?**
Yes, setting up this connection requires providing your specific Adyen API Key and Merchant Account ID. This ensures your agent is connected securely to your live payment environment.

**Does the Adyen MCP support different currencies for refunds?**
The tool supports managing payments across multiple global regions and currencies, allowing you to process accurate refunds regardless of where the original transaction occurred.