# Vouchery.io MCP > Vouchery.io MCP manages coupon codes, discount campaigns, and customer loyalty data. Use your AI agent to build complex promotional marketing workflows, generate unique voucher codes on demand, track redemptions, and manage entire campaign lifecycles. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** coupon-management, loyalty-programs, referral-marketing, digital-incentives, campaign-orchestration, customer-retention ## Description This connection lets you automate how your business runs its promotions and rewards. You'll use it to create structured discount campaigns, manage customer profiles, and handle the full lifecycle of digital incentives—all through natural conversation with your agent. Need a new loyalty reward? Your agent can generate unique voucher codes for specific campaigns without needing to manually enter anything. When customers redeem those vouchers, you get immediate details on who claimed it and when. You can also check out existing customer records or list all active promotions to see what's running right now. When dealing with high-stakes data like redemptions and sales figures, tracking is everything. Because the MCP runs inside Vinkius’s isolated sandbox, every tool call produces a cryptographically signed audit trail. This means you always know exactly which agent did what, when it happened, and where the data came from. You can build workflows that span marketing and finance, letting your AI client orchestrate complex promotional flows with absolute clarity. ## Tools ### create_campaign Sets up a new marketing campaign, requiring only its name and defined type. ### create_customer Create or update a customer profile ### create_voucher Generates a unique, single-use voucher code linked to an existing campaign. ### delete_campaign Permanently removes a marked-as-expired marketing campaign from the database. ### delete_voucher Removes a specific voucher code from your system entirely. ### get_campaign Pulls detailed information for one specific campaign ID. ### get_customer Fetches the specific profile details for one named customer. ### get_voucher Retrieves the current status and rules for a specific voucher code. ### list_campaigns Provides an inventory of all currently active or expired marketing campaigns. ### list_customers Retrieves a list containing all customer records in your account. ### list_redemptions Lists all recorded redemptions for a given voucher code to check usage history. ### redeem_voucher Processes and validates a voucher claim, recording the transaction against a customer account. ## Prompt Examples **Prompt:** ``` Create a new discount campaign called 'Black Friday VIP 2024' in Vouchery and generate a unique promo code for it. ``` **Response:** ``` I've successfully created the 'Black Friday VIP 2024' discount campaign. I also generated a unique voucher code for it: 'BF-VIP-8A9F'. The campaign is now live and ready to be assigned to your top-tier customers. ``` **Prompt:** ``` Redeem the voucher code 'WELCOME-20' for customer 'sarah@piedpiper.com' under transaction ID 'TXN-49281'. ``` **Response:** ``` The voucher 'WELCOME-20' has been successfully redeemed for 'sarah@piedpiper.com'. The transaction 'TXN-49281' has been recorded in the campaign history, and her loyalty profile has been updated. ``` **Prompt:** ``` Show me the redemption history and current status for the promo code 'INFLUENCER-100'. ``` **Response:** ``` The voucher 'INFLUENCER-100' is currently active. It has been redeemed 42 times so far, with the most recent redemption by 'alex@starkindustries.com' on transaction 'TXN-10293'. It has 58 uses remaining before hitting its limit. ``` ## Capabilities ### Build Campaigns Create entire discount or referral campaigns by providing a name and defining its type. ### Manage Customers Create new customer records or pull up existing profiles to track their activity level. ### Generate Codes Create unique, ready-to-use voucher codes for any given marketing campaign. ### Process Redemptions Execute a claim on a voucher code and record the transaction details to track revenue. ### Track History List all past redemptions for a specific voucher or list all current customer records. ## Use Cases ### Handling seasonal sales spikes The marketing team needs to launch 'Summer Clearance.' Instead of manually setting up the discount, they ask their agent to `create_campaign` for the event. Next, the agent calls `create_voucher` to generate 500 unique codes and then `list_customers` to see who gets them first. ### Investigating a suspicious promotion The finance department suspects fraud on a voucher. They tell their agent to use `get_voucher` first, then run `list_redemptions` to check the full history of claims and find when the code was last used. ### Onboarding a new corporate client A B2B sales team signs a big deal. They ask their agent to use `create_customer` with all the company's details, then immediately call `create_campaign` and generate specific vouchers for the account manager. ### Cleaning up old data It's year-end. The team needs to retire three old promotions. They tell their agent to first use `get_campaign` on each one, and then call `delete_campaign` for the final cleanup. ## Benefits - Run complex campaigns without switching tabs. You can use `list_campaigns` to see what's running, then call `create_voucher` to generate the reward codes for a new program. - Track customer engagement perfectly. Use `get_customer` and `list_redemptions` together to understand exactly which customers are using their rewards and how often. - Stop manual tracking of sales. The `redeem_voucher` tool handles the entire transaction flow, logging the claim immediately so your team never misses a sale detail. - Keep data clean by automating cleanup. You can use natural language prompts to call `delete_campaign` or `delete_voucher`, removing expired assets from your database. - Manage customer records instantly. Use `create_customer` when onboarding new users, ensuring their profile is set up with all necessary details before they redeem a code. ## How It Works The bottom line is, you tell the AI agent what marketing goal you have; the MCP executes the necessary steps against Vouchery.io to make it happen. 1. Subscribe to this MCP and provide your Vouchery.io API key from the dashboard. 2. Select whether you're testing in Preview mode or running live campaigns in Production. 3. Start telling your agent what needs doing—whether it’s listing all customers, creating a new campaign, or redeeming a voucher. ## Frequently Asked Questions **How do I check if a specific promo code is still valid using the get_voucher tool?** You run `get_voucher` and provide the exact code. The details returned show its current status, how many uses are left, and if it has expired or been deleted. **Can I use create_campaign to set up a promotion for a new customer?** You first need to `create_customer` with the user's details. Then you can use that profile information when calling `create_campaign`, ensuring the promo is tied to an active user. **What tools do I use to see all my current marketing campaigns?** Use `list_campaigns` for a quick inventory of everything. If you want deep details on one specific campaign, run `get_campaign` after retrieving the ID. **Is there an easy way to process multiple voucher claims at once?** The agent can process them sequentially for you. You prompt it with a list of codes and tell it to execute `redeem_voucher` for each one, logging the results as they come in. **If I suspect fraud, how can I use list_redemptions to audit and track every usage of a specific voucher code?** The `list_redemptions` tool provides a full audit trail for any given voucher. You get detailed records showing who claimed it, when they used it, and the transaction ID recorded against the claim. **When should I use create_customer instead of updating existing profiles to manage user data?** While you can update customer info using `create_customer`, use this tool whenever you need to ensure a profile exists or when initial onboarding data needs to be established. It handles both creation and modification. **What steps do I take to decommission an old promotion after it runs its course, specifically using delete_campaign?** To clean up your database, call `delete_campaign`. This removes the entire campaign structure from Vouchery.io, ensuring that expired promotions don't clutter your active records. **Before I generate new vouchers, how can I use list_customers to pull a reliable roster of eligible users for my marketing plan?** Running `list_customers` gives you a complete list of all current customer profiles in your system. This lets you validate who qualifies for the new campaign before generating codes. **How do I find my Vouchery.io API Key?** Log in to your Vouchery.io dashboard, navigate to **Settings** > **API Keys**, and generate a new key for your integration. **What is the Preview environment used for?** The Preview mode (preview.vouchery.io) is a sandbox environment where you can test your campaigns and voucher redemptions without affecting your live production data.