Adyen MCP Server for Mastra AI 4 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Adyen through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"adyen": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Adyen Agent",
instructions:
"You help users interact with Adyen " +
"using 4 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Adyen?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Adyen MCP Server
Connect your Adyen account to your AI agent to unlock enterprise-grade payment orchestration and financial management. From monitoring real-time transaction statuses to handling refunds and auditing merchant account configurations, your agent handles your global payment ecosystem through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Adyen tool infrastructure. Connect 4 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Payment Monitoring — List and retrieve details for authorized, captured, or refused payments across your accounts
- Refund & Modification — Initiate refunds and manage payment modifications (captures, cancels) directly from chat
- Merchant Oversight — List and audit your merchant accounts and their technical configurations via the Management API
- Payment Method Auditing — Retrieve and verify available payment methods for specific regions and currencies
- Financial Insights — Quickly identify transaction trends and reconciliation patterns directly from your chat interface
The Adyen MCP Server exposes 4 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Adyen to Mastra AI via MCP
Follow these steps to integrate the Adyen MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 4 tools from Adyen via MCP
Why Use Mastra AI with the Adyen MCP Server
Mastra AI provides unique advantages when paired with Adyen through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Adyen without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Adyen tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Adyen + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Adyen MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Adyen, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Adyen as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Adyen on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Adyen tools alongside other MCP servers
Adyen MCP Tools for Mastra AI (4)
These 4 tools become available when you connect Adyen to Mastra AI via MCP:
get_merchant_details
Retrieve the technical configuration and status for a specific Adyen merchant account
get_payment_details
Requires the 16-digit PSP reference. Retrieve the full technical authorization and capture metadata for a specific Adyen payment
list_merchants
g. US, EU regions) and find a required Merchant ID. Retrieve all active merchant accounts associated with your Adyen company profile
refund_payment
Always double-check the amount before processing. Requires original PSP reference. Initiate a full or partial refund for a previously captured payment in Adyen
Example Prompts for Adyen in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Adyen immediately.
"Check the status of payment with PSP reference '8816123456789012'."
"Refund $25.00 for PSP reference '8516123456789012'."
"List all my active merchant accounts."
Troubleshooting Adyen MCP Server with Mastra AI
Common issues when connecting Adyen to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpAdyen + Mastra AI FAQ
Common questions about integrating Adyen MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Connect Adyen with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Adyen to Mastra AI
Get your token, paste the configuration, and start using 4 tools in under 2 minutes. No API key management needed.