How to Use the Vouchery.io MCP in Windsurf

Q: How do I list all current promotions in Vouchery.io using Windsurf?

You just tell Cascade to 'list campaigns.' It uses the listcampaigns tool and presents you with a clean, actionable list of every promotion running on Vouchery.io.

Q: Can I check if a customer exists before creating them in Vouchery.io via Windsurf?

Yep. You start by calling getcustomer with the user's ID or email. If it fails, Cascade knows you need to run createcustomer instead.

Q: If I want to see how many times a coupon was used, do I use Windsurf?

Absolutely. You'll run listredemptions. This gives you the full history of when and where a voucher was claimed against Vouchery.io.

Automate complex marketing campaigns and loyalty programs using Windsurf.

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 Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Campaign Lifecycle Management

The `create_campaign` tool lets you define a new discount or coupon program by simply providing the name and type. Cascade can chain this with listing existing campaigns via `list_campaigns`, letting you audit all your promotions before going live. You set the goal—say, 'launch a summer sale.' Windsurf figures out it needs to first call `create_campaign` and then use that resulting ID in subsequent steps.

Customer Profile Management

Need to check who qualifies for a discount? Use `get_customer` to pull any user’s profile details. If the record is missing, Cascade can prompt you to use `create_customer`, ensuring your customer data stays up-to-date. This tool set lets you manage both the people and the promotions in one automated flow.

Voucher Generation and Redemption

Generating a specific code is easy. You call `create_voucher` to get a new, unique coupon for a campaign. Later, if you need to track usage, Cascade can run `redeem_voucher` against that code or check all redemptions using `list_redemptions`. It’s about building the full audit trail of how and when coupons are used.

Setup guide

Set up Vouchery.io MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Vouchery.io MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Vouchery.io payment history." If connected, Cascade will call the Vouchery.io tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "voucheryio-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

You just tell Cascade to 'list campaigns.' It uses the `list_campaigns` tool and presents you with a clean, actionable list of every promotion running on Vouchery.io.

Yep. You start by calling `get_customer` with the user's ID or email. If it fails, Cascade knows you need to run `create_customer` instead.

Vouchery.io tracks customer profiles and campaign details. Specifically, the system handles structured data like voucher codes, which are generated via `create_voucher`.

Absolutely. You'll run `list_redemptions`. This gives you the full history of when and where a voucher was claimed against Vouchery.io.

The primary data type that needs careful handling during redemption is the voucher code itself. You must ensure the `redeem_voucher` tool validates the code exists before attempting any state changes.

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