Title: Adyen Model Context Protocol (MCP) server
URL Source: https://docs.adyen.com/development-resources/mcp-server/
Published Time: Wed, 02 Sep 2026 08:58:00 GMT
Markdown Content:
Why was this page helpful to you?
Solved my problem
Easy to understand
Good example
Another reason
Submit
Why was this page not helpful to you?
Couldn't find what I was looking for
Too complicated / Too many steps
Unclear language or terminology
Problem with the code / errors
Another reason
Submit
Thank you!
Your feedback helps us improve our product.
Why was this page helpful to you?
Solved my problem
Easy to understand
Good example
Another reason
Submit
Why was this page not helpful to you?
Couldn't find what I was looking for
Too complicated / Too many steps
Unclear language or terminology
Problem with the code / errors
Another reason
Submit
Thank you!
Your feedback helps us improve our product.
Press Ctrl K keys to search
Development resources
Overview
Authentication
API authentication types
API credentials
Roles
Client-side authentication
Migrate to client key
Integration
Webhooks
Configure and manage webhooks
Handle webhook events
Secure webhooks
Verify HMAC signatures
Webhook structure and types
Additional settings
Account settings webhooks
Troubleshoot webhooks
Testing your integration
Payments and modifications
Tokenization
Risk features
3D Secure 2 authentication
Result codes and refusal reasons
CVC/CVV/CID result codes
Test cards and credentials
Test card numbers
Alternative payment methods test credentials
Create test cards
API reference
Documentation and knowledge tools
Libraries
Logs
Webhook event logs
API logs
MCP server
API idempotency
Live endpoints
Developer dashboard
Versioning
Batch processing
Submit modifications
Submit through SFTP
Batch acknowledgement file
Batch file naming and structure
Batch request file
Authorisation request file
Authorisation for a card payment
Authorisation for an IBAN payment
Authorisation for a recurring payment
Authorisation with airline data
Authorisation for ACH Direct Debit
Modification request file
AuthorisationReferral request
Capture request
Capture with airline data
CancelOrRefund request
Cancel request
Refund request
RefundWithData request file
RefundWithData request
Payout request file
Payout request
PayoutModification request file
PayoutConfirm request
PayoutDecline request
AccountUpdater request file
StoreToken request file
StoreToken request for payout
Batch result file
Authorisation result file
Modification result file
RefundWithData result file
Payout result file
PayoutModification result file
Account Updater result file
Batch result file with validation errors
Import data from another payment provider
Import payment details for recurring payments
Import data into referral lists
Responses
Response handling
HTTP status codes
Error codes and messages
Raw responses
Mapping to Visa fee categories
Refusal reasons
Reference
Currency codes
PaymentMethodVariant
Partners
Application information
OAuth
SECURITY AND COMPLIANCE
Security resources
Protecting your Adyen integration
Allowlisting IP addresses
Identity and access management
Secure coding
API security
Protecting sensitive data
Transport Layer Security (TLS)
PGP encryption
Handling incidents
Data Protection API
PCI DSS compliance guide
PCI compliance levels
Engaging a QSA
SAQ A eligibility
Vulnerability scanning for ecommerce
Script security for ecommerce
Comparing E2EE and P2PE
Mutual authentication
Surcharge compliance guide
HomeDevelopment resourcesMCP server
Was this page helpful?
Copy as Markdown
Adyen Model Context Protocol (MCP) server
Integrate with our APIs using LLMs with our MCP server.
Learn more
Read more about the launch of our MCP server in our tech blog.
Our Model Context Protocol (MCP) server lets you use natural language with your chosen Large Language Model (LLM) client. This allows developers to use natural language to connect with Adyen's platform more easily and build new payment solutions faster.
How it works
Use our MCP server to integrate with our APIs through function calling. This lets you integrate and interact with Adyen APIs seamlessly. The MCP contains a set of tools that lets you interact with the Adyen APIs for common use cases, using your client of choice.
Currently, interactions with the following APIs are supported, we are working on adding more APIs and endpoints.
For a full overview of supported endpoints, see the list on GitHub.
To get started:
- Get your API credentials to authenticate the API requests you will make with our MCP server.
- Run the MCP server.
- Use our MCP with an LLM client to interact with our APIs using natural language.
Get your API credentials
To authenticate the requests you will make using the MCP, generate an API key. You will need your API key when running the MCP server.
Make sure that your API credential has the following roles, these roles are assigned to all web service users by default:
- Merchant PAL webservice role
- Checkout webservice role
- Management API—Payment methods read
- Management API—Account read
- Management API - Terminals read
- Management API — Assign Terminal
- Management API — Terminal actions read
- Management API — Terminal actions read and write
- Management API — Android files read
- Management API — Terminal settings read
- Management API — Terminal settings read and write
Run the MCP server
Run our MCP server locally to start interacting with our APIs using natural language. You need your API key to run the server, and authenticate API requests.
Test environment
You must have the following to run the MCP server for the test environment:
Run the following command:
Expand view
Copy link to code block
Copy code
Copy code
npx -y @adyen/mcp --adyenApiKey=ADYEN_API_KEY --env=TEST
Live environment
You must have the following to run the MCP server for the live environment:
Run the following command:
Expand view
Copy link to code block
Copy code
Copy code
npx -y @adyen/mcp --adyenApiKey=ADYEN_API_KEY --env=LIVE --livePrefix=YOUR_PREFIX_URL
Use the MCP server
After you start running the MCP server locally, use an LLM client of your choice to interact with our APIs using natural language.
Interactions with our MCP server consist of the following:
- Your prompt: You provide instructions to your LLM client using natural language. For example, "Refund order #12345" or "Create a €50 payment link for order #ABC789."
- LLM client: Your LLM client sends these instructions to the Adyen MCP server.
- The MCP server: Our MCP server uses converts these instructions into the specific Adyen API requests needed to perform the task using function calling.
- API request: The MCP server makes the API requests to carry out the task you asked for, like making a refund or creating a payment link.
See also
Was this page helpful?
Company
Resources
Developers
Legal
On this page
Development resources
Overview
Cookie Policy
This website uses cookies and other tracking technologies to enhance user experience and to analyze performance and traffic on our website. We also share information about your use of our site with our social media, advertising and analytics partners. If we have detected an opt-out preference signal then it will be honored. Further information is available in our Privacy Statement.
Accept Cookies Reject All
Cookie settings
Opt-Out Request Honored
Cookie Preference Center
When you visit our website, we may store or retrieve information on your browser, mostly in the form of cookies. This information might be about you, your preferences or your device and is mostly used to make the site work as you expect it to do. The information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies. Click on the different category headings to find out more and change our default settings. However, blocking some types of cookies may impact your experience of the site and the services we are able to offer. For more information, please see our
Cookie Policy
Allow All
Manage Consent Preferences
Strictly Necessary Cookies
Always Active
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.
Share Or Sale of Personal Data
Under the CPRA, you have the right to opt-out of the sale or sharing of your personal information to third parties. These cookies collect information for analytics and to personalize your experience with targeted ads. You may exercise your right to opt out of the sale or sharing of personal information by using this toggle switch. If you opt out we will not be able to offer you personalized ads and will not hand over your personal information to any third parties. Additionally, you may contact our legal department for further clarification about your rights as a California consumer by using this Exercise My Rights link.If you have enabled privacy controls on your browser (such as a plugin), we have to take that as a valid request to opt-out. Therefore we would not be able to track your activity through the web. This may affect our ability to personalize ads according to your preferences.
Cookie List
Clear
Apply Cancel
Consent Leg.Interest
Reject All Confirm My Choices