How to Use the Vouchery.io MCP in Mastra AI

Q: What happens if a voucher redemption fails with Vouchery.io using Mastra AI?

Mastra AI handles it by automatically retrying the redeemvoucher call, potentially with exponential backoff and different logic branches you define. It won't just fail; it will try to fix itself.

Build resilient, multi-step payment workflows with Mastra AI and Vouchery.io.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Vouchery.io MCP to Mastra AI

Create your Vinkius account to connect Vouchery.io 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 Vouchery.io with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Complex Voucher Redemption Workflows on Mastra AI

The `redeem_voucher` tool is key here. Instead of just calling it once, you build a workflow: try redemption; if payment fails, the system automatically retries with a different method. This handles failures gracefully. This means your agent doesn't just fail out; it executes conditional branches defined by Mastra AI’s engine.

Managing Campaigns and Customers via Mastra AI

You can set up a multi-step process that first calls `get_campaign` to verify promotion rules, then uses `create_customer` if the user isn't found. The workflow engine manages this sequence. It’s perfect for onboarding new users who need both a profile created and a campaign attached.

Automated Campaign Cleanup with Mastra AI

Sometimes you gotta clean up old data. A workflow can first call `list_campaigns` to get IDs, then loop through them calling `delete_campaign`. If one deletion fails (say, due to permissions), the workflow knows to stop and notify an admin. This reliable sequence is exactly what Mastra AI's built-in retry logic excels at.

Setup guide

Set up Vouchery.io 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 Vouchery.io 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: "voucheryio-mcp-client",
  servers: {
    "voucheryio-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Vouchery.io 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 Vouchery.io. 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 Vouchery.io 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 Vouchery.io MCP in Mastra AI

Mastra AI handles it by automatically retrying the `redeem_voucher` call, potentially with exponential backoff and different logic branches you define. It won't just fail; it will try to fix itself.

Absolutely. You can build workflows that chain actions, like checking a `get_customer` profile first, and only running the `create_voucher` if necessary.

Its built-in workflow engine ensures that steps run in order, handling retries and conditional logic so your campaign status is always accurate after a process runs.

Yes. You can define a robust workflow that lists all IDs using `list_campaigns` and then attempts to delete them, ensuring failures are caught and reported.

The server touches campaign details, customer profiles, and voucher codes during the lifecycle of a workflow, allowing for comprehensive state management.

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