# Rewardful MCP

> Rewardful connects your affiliate and referral programs directly to any AI client. List campaigns, onboard new partners, manage coupon codes, and track commissions in real time—all through simple conversation. It lets you automate partner management without leaving your chat window.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** affiliate-marketing, referral-program, commission-tracking, partner-management, stripe-integration

## Description

Managing an affiliate program usually means jumping between a dashboard, a spreadsheet, and a commission tracker. This MCP handles all of that by letting your AI agent interact directly with Rewardful. Need to onboard a new partner or check if a coupon code is still valid? Just ask. You can list active campaigns, register affiliates, and even process payouts without ever touching the web interface. It gives you instant access to everything from listing pending payments to generating single-use links for influencers.

If your workflow runs on natural language commands, this MCP makes it happen. With Vinkius, you connect once to your favorite AI client—be it Claude or Cursor—and gain control over your entire partner ecosystem in one place. Your agent becomes the operational hub for all things referrals and commissions.

## Tools

### create_affiliate_coupon
Generates a new, unique coupon code for an affiliate partner.

### create_affiliate_link
Builds a brand-new tracking link for marketing use.

### create_affiliate
Registers an entirely new individual or business as a Rewardful affiliate.

### create_campaign
Sets up a brand-new promotional campaign within the system.

### delete_commission
Removes an existing commission record from the ledger.

### generate_affiliate_sso
Creates a secure Single Sign-On link for instant affiliate dashboard access.

### get_affiliate_coupon
Retrieves the details of a specific, existing coupon code.

### get_affiliate_link
Looks up the status and details for a particular affiliate link.

### get_affiliate
Retrieves all profile data for a specific affiliate partner.

### get_campaign
Retrieves the full details and current status of a specified campaign.

### get_commission
Retrieves all payment data for one specific commission record.

### get_payout
Retrieves the details of a scheduled or completed payout batch.

### list_affiliate_coupons
Lists every coupon code currently active in the system.

### list_affiliate_links
Provides a complete list of all created affiliate tracking links.

### list_affiliates
Lists basic information for every registered affiliate partner.

### list_campaigns
Provides an overview of all currently active and inactive campaigns.

### list_commissions
Lists multiple commission records, allowing you to see who earned what and when.

### list_payouts
Provides a summary of all scheduled or pending payment batches.

### list_referrals
Lists records detailing traffic and signups generated by partners.

### pay_payout
Marks a selected payout batch as successfully paid.

### update_affiliate_link
Changes the token or destination URL for an existing affiliate link.

### update_affiliate
Modifies information on an already registered affiliate profile.

### update_campaign
Changes the rules, reward structure, or settings of a live campaign.

### update_commission
Adjusts the status or value for a specific commission record.

## Prompt Examples

**Prompt:** 
```
List all active Rewardful campaigns and their reward types.
```

**Response:** 
```
I've found 3 active campaigns: 'Early Adopters' (20% recurring), 'Summer Sale' ($50 flat), and 'Partner Program' (15% recurring). Which one would you like to manage?
```

**Prompt:** 
```
Register a new affiliate: John Doe (john@example.com) for campaign ID 'camp_123'.
```

**Response:** 
```
Successfully registered John Doe in the 'Early Adopters' campaign. Their affiliate ID is 'aff_987'. Would you like me to generate an SSO link for them?
```

**Prompt:** 
```
Show me the details for commission ID 'comm_456'.
```

**Response:** 
```
Commission 'comm_456' is for $24.50, currently in 'pending' status. It was generated by affiliate 'Jane Smith' for a Stripe subscription. Do you want to update its status?
```

## Capabilities

### Manage Campaigns
List, create, and modify affiliate campaigns, including setting reward structures and URLs.

### Handle Affiliates
Register new partners, retrieve existing profiles, and generate unique Single Sign-On (SSO) access links for them.

### Track Finances
List all commissions and payouts, query specific records, and update commission statuses or process payments.

### Create Marketing Assets
Generate new affiliate coupons and unique tracking links for partners and campaigns.

## Use Cases

### The End-of-Month Audit
A Finance Analyst needs to reconcile commissions before the board meeting. Instead of downloading massive CSV files and manually cross-referencing hundreds of rows, they ask their agent to list all commissions for a specific month. The system returns an organized summary, allowing them to quickly identify any discrepancies or pending payouts.

### The Influencer Onboarding Rush
A Growth Lead has 20 new influencers signing up right before a product launch. They use their agent to execute the `create_affiliate` tool for all twenty, then run `generate_affiliate_sso` on each one, instantly giving them access and tracking IDs without manual form filling.

### The Campaign Tweak
A Marketing Manager realizes a current campaign isn't hitting targets. Instead of logging into the Rewardful dashboard to find the settings, they ask their agent to `get_campaign` details and then use it to update the reward structure instantly.

### Cleaning Up Old Data
The Operations team needs to correct a commission error from last quarter. Instead of spending time finding the exact record in the backend, they simply ask their agent to `get_commission` details and then use it to update the necessary status or even delete an erroneous entry.

## Benefits

- Stop juggling tabs. You can list campaigns and view commissions without ever leaving the conversation with your AI agent.
- Speed up partner onboarding. Generate an SSO Magic Link or register a new affiliate instantly by asking, which saves minutes of clicks per person.
- Keep your finances clean. Use commands to list all commissions and process payouts, giving you immediate visibility into revenue streams.
- Stay ahead on promotions. You can create brand-new campaigns or update existing ones in natural language, making seasonal marketing faster than ever.
- Control the assets. Need a new coupon code? Just ask your agent to create an affiliate coupon, ensuring unique tracking for every campaign.

## How It Works

The bottom line is you tell your agent what needs doing, and it handles the complex API steps behind the scenes.

1. Subscribe to this MCP and provide your Rewardful Secret API Key.
2. Connect the service to any compatible AI client, giving your agent permission to perform actions on your behalf.
3. Use natural language commands in your chat window; your agent translates that request into specific calls to manage campaigns, affiliates, or commissions.

## Frequently Asked Questions

**How do I check the current status of pending payouts with Rewardful MCP?**
You use the list_payouts tool to get an overview, and then you can run get_payout for specific details. This lets you see if payments are scheduled or if they've already been marked as paid.

**Can Rewardful MCP help me onboard a new partner?**
Yes. You use the create_affiliate tool to register them, and then you can run generate_affiliate_sso to give them instant access links without sending multiple emails.

**What if I need to update a campaign's reward rate?**
You use the update_campaign tool. This lets your agent modify existing rules, like changing percentages or updating URLs, keeping your promotions current with just a few words.

**Does Rewardful MCP support listing all active coupons?**
Yes, you can list all affiliate coupons using the list_affiliate_coupons tool. This provides a quick inventory of every code currently running in your programs.

**Is it possible to delete an old commission record with Rewardful MCP?**
The delete_commission tool allows you to remove specific commission records if they are erroneous or need to be audited out of the active ledger, keeping your data clean.