# ReferralHero MCP for AI Agents AI Agent Connect

> ReferralHero. Automate viral referral campaigns by managing subscribers, rewards, and leaderboards through your AI agent. Get real-time growth data and handle participant rewards without leaving your chat interface.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ePLlmy4BVCx8LOg3slIHts6pJKt2dvuI0gEpZzZU/ai-agent-connect
- **Tags:** referralhero, viral-growth, referral-api, subscriber-management, leaderboards, rewards-automation, growth-marketing, mcp

## Description

ReferralHero connects your growth engine to your AI agent so you can manage referral programs through a simple conversation. Instead of jumping between tabs to check who's winning a contest or how many points a user has, you can just ask your agent for the status. It handles the heavy lifting of pulling subscriber metadata, monitoring campaign leaderboards, and updating reward balances on the fly. When you use this through the Vinkius catalog, your agent becomes a dedicated growth coordinator. You can spot conversion trends, track specific referral events, and keep your growth loops synchronized without manual exports. It turns a complex backend into a conversational dashboard where you can handle everything from adding new participants to auditing transaction history. You'll stop hunting for data in spreadsheets and start making moves based on what's happening right now.

## Tools

### delete_subscriber
Remove a specific user from a campaign list. This helps keep your active participant data clean.

### get_leaderboard
Pull the current ranking of top referrers for a campaign. Use this to see who's winning your growth loop.

### get_list
Fetch all the metadata and details for a specific referral campaign. It gives you the full context of a list.

### get_rewards
See the specific rewards available for a campaign. This helps you communicate incentives to your users.

### get_subscriber
Look up the profile and point balance for a single participant. Use this for quick individual lookups.

### list_lists
See a full list of all your managed referral campaigns. It's the fastest way to see your entire portfolio.

### list_subscribers
Get a list of every person joined in a specific campaign. This is great for auditing your total reach.

### list_transactions
View a history of recent point and reward movements. Use this to audit your program's spend.

### track_conversion
Record a new referral event to keep growth loops accurate. This ensures your data stays in sync.

### update_subscriber
Change the details of an existing participant in your system. Use this to keep user info current.

### add_points
Give a subscriber extra points for a specific action. This is how you reward high-value behavior.

### add_subscriber
Put a new person into a referral campaign. You can do this quickly via natural language.

## Prompt Examples

**Prompt:** 
```
Who are the top 5 referrers in my 'Summer Sale' campaign?
```

**Response:** 
```
Here are the top 5 referrers for the **Summer Sale** campaign:

| Rank | Name | Referrals | Rewards Earned |
| :--- | :--- | :--- | :--- |
| 1 | Sarah J. | 42 | $420 |
| 2 | Mike R. | 38 | $380 |
| 3 | Elena W. | 31 | $310 |
| 4 | David K. | 29 | $290 |
| 5 | Chloe B. | 25 | $250 |

Total participants in this campaign: 1,240.
```

**Prompt:** 
```
Can you add 500 points to the user with ID user_9921?
```

**Response:** 
```
Done. I've added **500 points** to the subscriber profile for **user_9921**. Their new balance is now updated in the ReferralHero system.
```

**Prompt:** 
```
Show me the recent transactions for the 'Early Bird' list.
```

**Response:** 
```
Here are the most recent transactions for the **Early Bird** campaign:

* **User #4421**: +100 points (Referral) - *2 mins ago*
* **User #3309**: +50 points (Sign-up) - *14 mins ago*
* **User #2118**: +200 points (Milestone) - *1 hour ago*
* **User #1092**: +100 points (Referral) - *2 hours ago*
```

## Capabilities

### Pull campaign leaderboards
Get the current ranking of top referrers for any active campaign.

### Update subscriber point balances
Give participants extra points for completing specific milestones.

### Track new referral conversions
Record new sign-ups to keep your growth loops accurate.

### List all active referral campaigns
See every campaign you're currently running in one view.

### Audit recent transaction history
View a history of point and reward movements for your users.

### Add new participants to a campaign
Put new people into your referral programs via chat.

## Use Cases

### Live launch leaderboard tracking
A growth lead needs to see the top 10 referrers during a live launch and asks the agent to show the leaderboard.

### VIP reward manual override
A marketing ops person needs to give a VIP customer 500 extra points and uses the point addition tool to do it.

### Campaign reach audit
A founder wants to see how many people joined a specific campaign last week and asks for a subscriber list.

### Customer reward troubleshooting
A customer success rep needs to find a user's balance to see why they haven't received a reward yet.

## Benefits

- Stop manual exports by using get_leaderboard to see rankings instantly without opening a CSV.
- Update rewards faster with add_points instead of making manual database edits for your users.
- Keep growth loops accurate by using track_conversion to log every new sign-up automatically.
- Audit your program easily with list_transactions to see exactly where your points are going.
- Manage your entire portfolio at once by using list_lists to see every campaign in one view.
- Get instant answers on user status by using get_subscriber to see balances and history.

## How It Works

The bottom line is you get a hands-on growth manager that lives inside your favorite AI chat.

1. Connect your ReferralHero account to the Connector via Vinkius.
2. Provide your API token from your ReferralHero account settings.
3. Ask your AI client to check your growth stats or update a user's points.

## Frequently Asked Questions

**How does the ReferralHero MCP help with viral growth?**
It lets you manage the mechanics of your referral loops in real-time. You can track conversions, update rewards, and monitor leaderboards instantly through your AI agent.

**Can I use ReferralHero MCP to update user points automatically?**
Yes. You can ask your AI agent to add points to specific subscribers based on actions they complete, removing the need for manual updates.

**Does ReferralHero MCP support multiple campaigns?**
It does. You can list all your active campaigns and pull specific data, like leaderboards or subscriber lists, for any of them.

**Is ReferralHero MCP good for marketing operations teams?**
It's ideal for ops teams who need to audit transactions, manage subscriber metadata, and handle reward distributions without switching between different tools.

**Can I see who is winning my referral contest with ReferralHero MCP?**
Absolutely. You can pull the full leaderboard for any campaign to see exactly who has the most referrals and how many rewards they've earned.

**How do I connect ReferralHero to my AI agent?**
You just need to subscribe to the Connector on Vinkius and provide your ReferralHero API token. From there, your agent can access all the tools for you.

**Can my AI automatically find the details and points for a specific subscriber by providing their ID?**
Yes! Use the `get_subscriber` tool with the List UUID and Subscriber ID. Your agent will respond with complete metadata, including referral counts and current point balances in seconds.

**How do I find my ReferralHero API Token?**
Log in to your ReferralHero dashboard, navigate to **Account** > **API**, and you will find your unique secret token there.