mcp-adyen — Claude Code MCP server: what it does, how to install
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.
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-adyenWhat mcp-adyen 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.
What it helps with
- 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 for the agent
- 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.
How to install mcp-adyen
Platform CLI
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-adyenReplace <…> with your own values
Platform CLI
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-adyenReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-adyenReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-adyen
How do I install mcp-adyen in Claude Code?
Run claude mcp add mcp-adyen -e ADYEN_API_KEY=<ADYEN_API_KEY> -e ADYEN_MERCHANT_ACCOUNT=<ADYEN_MERCHANT_ACCOUNT> -- npx -y @codespar/mcp-adyen.
What does mcp-adyen do?
It connects Claude Code to Adyen Checkout API v71 and exposes tools for payments, refunds, payment links, disputes, balances, and transfers.
What does mcp-adyen need for live requests?
Provide ADYEN_API_KEY, ADYEN_MERCHANT_ACCOUNT, ADYEN_ENV=live, and ADYEN_LIVE_URL_PREFIX. Live calls fail without the prefix.
