# mcp-adyen

Connect an AI coding client to Adyen Checkout API v71 for payments, refunds, disputes, and hosted payment links. Useful when Adyen is part of the flow.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/adyen
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-adyen

## What it does

mcp-adyen exposes 25 tools for Adyen operations. An agent can create and complete payment flows, capture or cancel authorized payments, issue full or partial refunds, adjust an unsettled amount, and query payment methods for a country, currency, and amount. It also handles hosted payment links, saved payment methods, donations, and Checkout sessions.

The server includes dispute actions for accepting a case, defending it with an accepted reason code, and sending a supporting document. Other tools cover balance accounts, transfers, and merchant accounts visible to the credential. Set `ADYEN_API_KEY` and `ADYEN_MERCHANT_ACCOUNT` before launch; `ADYEN_ENV=test` is the default. Live requests require `ADYEN_LIVE_URL_PREFIX`, and they fail when that value is missing.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ADYEN_API_KEY`, `ADYEN_MERCHANT_ACCOUNT`, `ADYEN_ENV`, `ADYEN_LIVE_URL_PREFIX` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ADYEN_API_KEY=<ADYEN_API_KEY> --env ADYEN_MERCHANT_ACCOUNT=<ADYEN_MERCHANT_ACCOUNT> --env ADYEN_ENV=<ADYEN_ENV> --env ADYEN_LIVE_URL_PREFIX=<ADYEN_LIVE_URL_PREFIX> --transport stdio adyen -- npx -y @codespar/mcp-adyen
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add adyen --env ADYEN_API_KEY=<ADYEN_API_KEY> --env ADYEN_MERCHANT_ACCOUNT=<ADYEN_MERCHANT_ACCOUNT> --env ADYEN_ENV=<ADYEN_ENV> --env ADYEN_LIVE_URL_PREFIX=<ADYEN_LIVE_URL_PREFIX> -- npx -y @codespar/mcp-adyen
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adyen": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-adyen"
            ],
            "env": {
                "ADYEN_API_KEY": "<ADYEN_API_KEY>",
                "ADYEN_MERCHANT_ACCOUNT": "<ADYEN_MERCHANT_ACCOUNT>",
                "ADYEN_ENV": "<ADYEN_ENV>",
                "ADYEN_LIVE_URL_PREFIX": "<ADYEN_LIVE_URL_PREFIX>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "adyen": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-adyen"
            ],
            "env": {
                "ADYEN_API_KEY": "<ADYEN_API_KEY>",
                "ADYEN_MERCHANT_ACCOUNT": "<ADYEN_MERCHANT_ACCOUNT>",
                "ADYEN_ENV": "<ADYEN_ENV>",
                "ADYEN_LIVE_URL_PREFIX": "<ADYEN_LIVE_URL_PREFIX>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ADYEN_API_KEY=<ADYEN_API_KEY> -e ADYEN_MERCHANT_ACCOUNT=<ADYEN_MERCHANT_ACCOUNT> -e ADYEN_ENV=<ADYEN_ENV> -e ADYEN_LIVE_URL_PREFIX=<ADYEN_LIVE_URL_PREFIX> adyen npx -y @codespar/mcp-adyen
```
Replace <…> with your own values

## When to use it
- create an Adyen payment
- capture or refund a transaction
- generate a hosted payment link
- submit a dispute defense
- start a balance account transfer

## Example prompts
- Create a payment for the current order and return the authorization result.
- List payment methods for this country, currency, and order amount.
- Defend this dispute and upload the supporting document.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md