MCPgee
MCPgee
MCPgeeMCPgee

Adyen

v1.0.0•Finance & Fintech•stable

Typescript library for integrating Adyen APIs via an MCP server

adyenlllmllm-agentsmcpmcp-server
Share:
22
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Adyen?

Adyen is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to typescript library for integrating adyen apis via an mcp server

Typescript library for integrating Adyen APIs via an MCP server

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Typescript library for integrating Adyen APIs via an MCP ser

Use Cases

Integrate Adyen payment APIs for transaction processing.
Enable AI agents to manage payments and financial operations.
Adyen

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 14, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx adyen

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Adyen

The Adyen MCP Server is an official TypeScript library from Adyen that exposes the full Adyen payment platform API to AI agents and MCP clients. It covers the Checkout API (sessions, payment links, refunds, cancellations) and the Management API (merchant accounts, terminals, webhooks, payment methods, users, and API credentials) through ten capability groups totaling dozens of individual operations. Developers and fintech teams use it to let Claude or other AI agents query transaction data, issue refunds, manage POS terminals, and build payment workflows entirely through natural language.

Prerequisites

  • Node.js 18 or later installed
  • An Adyen account with API credentials (available from the Adyen Customer Area)
  • An Adyen API key with appropriate roles for the operations you need
  • An MCP-compatible client such as Claude Desktop or VS Code with MCP support
1

Obtain your Adyen API key

Log in to the Adyen Customer Area, navigate to Developers → API credentials, and create a new API credential or copy an existing key. Best practice: create a dedicated webservice user with only the roles your use case requires.

2

Test the server with npx

Run the server directly with npx to verify your API key works before adding it to your MCP client config. Use 'TEST' environment for sandboxing.

npx -y @adyen/mcp --adyenApiKey=YOUR_ADYEN_API_KEY --env=TEST
3

Add the server to your MCP client configuration

Add the Adyen MCP server to your claude_desktop_config.json using the command-line arguments for authentication.

{
  "mcpServers": {
    "adyen": {
      "command": "npx",
      "args": ["-y", "@adyen/mcp", "--adyenApiKey=YOUR_ADYEN_API_KEY", "--env=TEST"]
    }
  }
}
4

Switch to LIVE environment when ready

For production use, change the env flag to LIVE and add your live URL prefix from the Adyen Customer Area.

{
  "mcpServers": {
    "adyen": {
      "command": "npx",
      "args": ["-y", "@adyen/mcp", "--adyenApiKey=YOUR_LIVE_API_KEY", "--env=LIVE", "--livePrefix=YOUR_LIVE_PREFIX"]
    }
  }
}
5

Restart Claude Desktop and verify

Restart Claude Desktop and ask it to list your merchant accounts. A successful response confirms the server is connected and authenticated.

Adyen Examples

Client configuration

claude_desktop_config.json entry for Adyen MCP server in TEST mode.

{
  "mcpServers": {
    "adyen": {
      "command": "npx",
      "args": ["-y", "@adyen/mcp", "--adyenApiKey=AQElahmfuXNWIxVJmb...", "--env=TEST"]
    }
  }
}

Prompts to try

Example prompts covering the ten Adyen API capability groups.

- "List all my Adyen merchant accounts."
- "Create a payment link for $49.99 USD and set it to expire in 24 hours."
- "Issue a refund for payment PSP reference ABC123XYZ."
- "List all POS terminals for merchant account MyStore_EU and show their software versions."
- "Show me all webhooks configured for my merchant account and their current status."

Troubleshooting Adyen

403 Forbidden errors when calling Management API endpoints

The API credential you are using lacks the required role. Go to Adyen Customer Area → Developers → API credentials, select your credential, and add the Management API roles under 'Roles'.

Live endpoint calls fail with 'Unknown prefix' error

When using --env=LIVE, you must also provide --livePrefix with the prefix value from your Adyen live account. Find it in Customer Area under Account → API URLs.

npx takes a long time or hangs on first run

The @adyen/mcp package is downloaded on first use. Ensure you have a stable internet connection and that your npm cache is not corrupted ('npm cache clean --force' then retry).

Frequently Asked Questions about Adyen

What is Adyen?

Adyen is a Model Context Protocol (MCP) server that typescript library for integrating adyen apis via an mcp server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Adyen?

Follow the installation instructions on the Adyen GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Adyen?

Adyen works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Adyen free to use?

Yes, Adyen is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Adyen Alternatives — Similar Finance & Fintech Servers

Looking for alternatives to Adyen? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.

ValueCell

★ 10.7k

ValueCell is a community-driven, multi-agent platform for financial applications.

Vibe Trading

★ 8.1k

'Vibe-Trading: Your Personal Trading Agent'

Quantdinger

★ 6.2k

AI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading

TradingView

★ 2.8k

Real-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.

Financial Datasets

★ 2.1k

Provides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.

Stripe

★ 1.6k

The Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Finance & FintechBrowse All Servers

Quick Config Preview

{ "mcpServers": { "adyen": { "command": "npx", "args": ["-y", "adyen"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Adyen?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides