How to Use the Mollie MCP in Mastra AI

Q: How do I add Mollie tools to a Mastra AI agent?

Instantiate the MCPClient with your Vinkius server URL and pass the tools to your agent. This lets the agent invoke createpayment or getorder when executing workflows.

Q: How do I require human approval for Mollie refunds in Mastra AI?

Use the requireToolApproval option in your agent configuration before executing getrefund or processing a payout. This keeps a human in the loop for high-value transactions.

Build automated checkout workflows using Mastra AI and the Mollie MCP Server to handle payments and retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mollie MCP to Mastra AI

Create your Vinkius account to connect Mollie to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Mollie with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Failed Payments with Mastra AI Workflows

`create_payment` triggers within your Mastra AI workflow to start a checkout sequence. If the payment fails, the workflow engine automatically branches to try a different method or alert the customer. You write the logic in TypeScript, and the agent handles the rest. This prevents abandoned carts without requiring manual intervention from your support team.

Conditional Refund Handling via MCP Server

`get_refund` checks the status of a returned item before triggering any restocking workflows. Mastra AI uses this tool to verify the refund is complete before updating your inventory database. By chaining these tools, you build a self-healing system. The workflow retries the check with exponential backoff if the Mollie API experiences temporary downtime.

Automated Dispute Resolution Runs

`list_chargebacks` retrieves disputed transactions so your agent can flag suspicious accounts. The framework runs this check on a schedule, triggering immediate alerts when a chargeback occurs. This replaces manual dashboard monitoring. Your agents scan the list, decide on the risk level, and update customer profiles automatically.

Setup guide

Set up Mollie MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Mollie tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "mollie-mcp-client",
  servers: {
    "mollie-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Mollie Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Mollie tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Mollie transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mollie. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Mollie now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Mollie MCP in Mastra AI

Instantiate the `MCPClient` with your Vinkius server URL and pass the tools to your agent. This lets the agent invoke `create_payment` or `get_order` when executing workflows.

Yes, the built-in workflow engine handles retries with exponential backoff if `create_payment` fails. This ensures temporary network issues don't kill your sales.

Use the `requireToolApproval` option in your agent configuration before executing `get_refund` or processing a payout. This keeps a human in the loop for high-value transactions.

Yes, you can deploy your entire agent setup with a single command. The connection to the MCP server remains stable across any serverless provider.

Vinkius processes all customer records and payment histories in an ephemeral sandbox. No sensitive financial data is stored on our servers, ensuring PCI compliance.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript