Adyen MCP. Manage payments and audit accounts via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Adyen MCP Server connects your AI agent directly to your global payment platform. Manage payments, initiate refunds, and audit merchant accounts from chat.
It lets you list transactions, check status, and manage merchant configurations using natural conversation.
What your AI agents can do
Get merchant details
Retrieves the technical setup and current status for a specific Adyen merchant account.
Get payment details
Gets the full authorization and capture data for a specific Adyen payment using its 16-digit PSP reference.
List merchants
Retrieves a list of all active merchant accounts linked to your Adyen company profile.
Use get_payment_details to retrieve the full authorization and capture metadata for a specific payment using its 16-digit PSP reference.
Initiate a full or partial refund for a previously captured payment using the refund_payment tool. You must provide the original PSP reference and the desired amount.
Call list_merchants to get a list of all active merchant accounts associated with your Adyen profile.
Run get_merchant_details to check the technical configuration and current status of a specific merchant account.
Retrieve and verify available payment methods for specific regions and currencies.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019d7548get merchant details
Retrieves the technical setup and current status for a specific Adyen merchant account.
019d7548get payment details
Gets the full authorization and capture data for a specific Adyen payment using its 16-digit PSP reference.
019d7548list merchants
Retrieves a list of all active merchant accounts linked to your Adyen company profile.
019d7548refund payment
Starts a full or partial refund for a payment that was previously captured, requiring the original PSP reference.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Adyen, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Adyen MCP Server connects your AI agent right into your global payment platform. You can manage payments, handle refunds, and audit merchant accounts—all from a natural conversation. Your agent lets you list transactions, check statuses, and manage merchant setups without ever leaving your chat.
How Adyen MCP Works
- 1 Subscribe to the Adyen MCP Server. You'll need your Adyen API Key and Merchant Account ID.
- 2 Connect your preferred client (Claude, Cursor, etc.) to the server.
- 3 Start sending commands to your agent, like 'Check the status of payment X' or 'Refund $Y for PSP Z'. The agent runs the necessary tools and provides the result.
The bottom line is, you talk to your agent, and the agent uses your Adyen credentials to run the payment operations.
Who Is Adyen MCP For?
This is for finance operations teams and e-commerce managers who handle payments daily. If you spend time cross-referencing transaction statuses across dashboards or manually initiating refunds, this saves hours. It lets you manage your entire payment flow—from checking a failed transaction to auditing a merchant account—without leaving your chat window.
Automates audit tasks, running checks and initiating refunds for failed or disputed payments.
Monitors checkout health in real-time, checking payment method availability and payment statuses on the fly.
Resolves complex billing inquiries by checking detailed transaction history and payment records.
Verifies API integration points and inspects payment responses using simple, conversational commands.
What Changes When You Connect
- Check transaction status instantly. Instead of logging into the Adyen dashboard, you ask your agent to run
get_payment_detailsand get the full history for a PSP reference. This is immediate visibility. - Automate refund processing. Use
refund_paymentto start refunds for captured payments. You just specify the amount and the original reference number. - Audit all your accounts.
list_merchantspulls all your active accounts into one view. You don't have to click through multiple dashboards to see them all. - Verify payment methods on the fly. You can check which payment methods work for a given region and currency without leaving your workflow.
- Deep merchant oversight.
get_merchant_detailslets you audit the technical setup of a specific merchant account, ensuring compliance and correct configuration.
Real-World Use Cases
Investigating a failed checkout payment
A customer claims a payment failed. Instead of manually checking the dashboard, you tell your agent: 'Check the status of payment X.' The agent runs get_payment_details and immediately confirms if the payment was authorized, captured, or refused, solving the issue fast.
Batch processing multiple refunds
You need to issue 15 partial refunds for a recent sale. Instead of logging in and running 15 separate transactions, you ask your agent to use refund_payment repeatedly with the batch data, logging the status of each one.
Auditing new e-commerce regions
Before launching in a new market, you need to know what payment methods are available. You ask your agent to check payment method availability for that region and currency, verifying operational readiness before going live.
Checking company-wide merchant status
A developer needs to know if all company subsidiaries have their Adyen accounts configured correctly. You run list_merchants and then use get_merchant_details on each one to confirm the status, all from a single chat prompt.
The Tradeoffs
Manually jumping through dashboards
You open the Adyen portal, navigate to 'Payments,' filter by date, download the CSV, open Excel, and then cross-reference the amounts with your internal ledger.
→
Let your agent run get_payment_details with the PSP reference. The agent pulls the exact metadata you need and presents it right here, skipping the manual data handling.
Assuming one endpoint covers everything
Trying to get payment details and merchant setup from a single, all-encompassing 'overview' endpoint, only to find missing fields or inaccurate data.
→
Use the specialized tools. Check general status with get_payment_details, then check the account configuration separately with get_merchant_details. The system uses focused tools for accuracy.
Calling the wrong tool for the job
Running list_merchants when you actually need to check the technical settings of a single, known merchant ID.
→
First, use list_merchants to get the IDs. Then, specifically call get_merchant_details using the ID you found. This ensures you get the exact technical configuration you need.
When It Fits, When It Doesn't
Use this server if your core job involves auditing, monitoring, or modifying payments and merchant accounts. You need to check payment statuses (get_payment_details), initiate refunds (refund_payment), or audit merchant technical setups (get_merchant_details).
Don't use this if you just need a simple, read-only data export of all transactions over the last year. For that, a dedicated data warehouse connection is better. If you are building a complex, multi-stage data pipeline, consider a specialized data connector instead of an operational MCP server.
This server works best when your goal is immediate action: 'What happened to payment X?' or 'Refund payment Y.'
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Adyen. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 4 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking payment status usually means logging into a dashboard and clicking through five pages.
Right now, checking a payment status requires logging into the Adyen portal. You search for the PSP reference, click 'View Details,' and then dig through multiple tabs—authorization, capture, settlement. You're copying down dates, amounts, and statuses, and you'll probably spend 15 minutes just gathering the raw facts.
With the Adyen MCP Server, you just ask your agent. You say, 'What's the status of payment X?' The agent runs `get_payment_details` and spits out the full, structured metadata instantly. It's all right here, ready to use.
Adyen MCP Server: Handle payments and merchant accounts from chat.
You eliminate the need to switch context. You no longer have to copy a merchant ID from one screen, switch to a different portal, and then paste it into a separate form to audit the technical settings. The agent manages the workflow using `get_merchant_details` and `list_merchants` in the background.
You manage your global payment lifecycle without opening a single browser tab. The entire process stays conversational, making complex operations feel simple.
Common Questions About Adyen MCP
How do I use the `refund_payment` tool with Adyen MCP Server? +
You must provide the original PSP reference and the exact amount for the refund. The agent will use this to initiate the partial or full refund process.
Can I list all my merchant accounts using `list_merchants`? +
Yes, list_merchants retrieves all active merchant accounts associated with your Adyen company profile. You'll get a list of IDs you can then use for deeper audits.
Does `get_payment_details` require a specific format? +
Yes, it requires the 16-digit PSP reference. This unique identifier lets the agent pull the full technical data for that specific payment.
What if I need to audit a specific merchant account's setup? +
Use get_merchant_details and provide the specific merchant ID. This tool gives you the technical configuration and current status, which is more detailed than a simple list.
How do I use `get_merchant_details` to check a single account? +
You pass the specific Merchant ID to get_merchant_details. This tool retrieves the technical setup and current status for one Adyen account. You'll get details like the account's configuration and operational status.
What format does `get_payment_details` need for the PSP reference? +
It requires the 16-digit PSP reference number. This reference links to the full authorization and capture data for a single Adyen payment, letting you verify its status.
Can `refund_payment` handle partial refunds? +
Yes, you can initiate partial refunds. Just provide the original PSP reference and the exact amount you want to refund. The system handles the partial deduction.
What information does `list_merchants` provide about my accounts? +
list_merchants returns all active merchant accounts associated with your Adyen profile. This list provides the names and IDs needed to manage your global payment ecosystem.
How do I find my Adyen API Key? +
Log in to your Adyen Customer Area, go to Developers > API credentials, and select your web service user (ws@Company.YourCompany). You can generate and copy your API key from the 'Authentication' section.
Can I process a refund via the agent? +
Yes! Use the refund_payment tool and provide the original PSP reference and the amount. Your agent will submit the refund request to Adyen for processing.
Does this support checking payment statuses? +
Yes, the get_payment_details tool allows you to retrieve the full technical response for any PSP reference, including authorization codes and refusal reasons.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Highnote
Automate card issuance and financial management via Highnote — manage account holders, cards, and transactions directly from any AI agent.
Worldpay
Process payments, manage refunds, and audit settlements on Worldpay — the global leader in payment processing technology.
Instamojo
Manage payments, refunds, and payouts via Instamojo API.
You might also like
Deterministic Text Summarizer & Extractor
Equip your AI with pure Term Frequency (TF) text analysis. Deterministically extract keywords, bigrams, and generate extractive summaries without external API calls.
Giddyup
Coordinate field service teams with job dispatching, route optimization, and real-time status updates for mobile workforces.
Evil Insult
Generate creative and random insults from the Evil Insult Generator API directly within your AI agent.