ReferralHero Connector for AI agents.
12 live capabilities
Manage viral referral programs and reward balances through a conversational interface.
Waiting for input…
Why people use ReferralHero
ReferralHero Viral Growth Management
This Connector lets you skip the export entirely. You just ask your agent to show the leaderboard or update a user's points. It pulls the data directly from ReferralHero and gives you the answer in seconds. You get a clean, conversational way to run your growth operations.
What Vinkius changes
You get a hands-on growth manager that lives inside your favorite AI chat.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
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.
- Real-world use case 02
VIP reward manual override
A marketing ops person needs to give a VIP customer 500 extra points and uses the point addition capability to do it.
- Real-world use case 03
Campaign reach audit
A founder wants to see how many people joined a specific campaign last week and asks for a subscriber list.
Complete set · 12capabilities
The complete ReferralHero capability set.
These are the exact actions your AI can choose when you ask it to work with ReferralHero.
01—04
4 capabilities in this set.
Part of 12 available through ReferralHero.
- 01 Capability
Delete subscriber
Remove a specific user from a campaign list. This helps keep your active participant data clean.
- 02 Capability
Get leaderboard
Pull the current ranking of top referrers for a campaign. Use this to see who's winning your growth loop.
- 03 Capability
Get list
Fetch all the metadata and details for a specific referral campaign. It gives you the full context of a list.
- 04 Capability
Get rewards
See the specific rewards available for a campaign. This helps you communicate incentives to your users.
05—08
4 capabilities in this set.
Part of 12 available through ReferralHero.
- 05 Capability
Get subscriber
Look up the profile and point balance for a single participant. Use this for quick individual lookups.
- 06 Capability
List lists
See a full list of all your managed referral campaigns. It's the fastest way to see your entire portfolio.
- 07 Capability
List subscribers
Get a list of every person joined in a specific campaign. This is great for auditing your total reach.
- 08 Capability
List transactions
View a history of recent point and reward movements. Use this to audit your program's spend.
09—12
4 capabilities in this set.
Part of 12 available through ReferralHero.
- 09 Capability
Track conversion
Record a new referral event to keep growth loops accurate. This ensures your data stays in sync.
- 10 Capability
Update subscriber
Change the details of an existing participant in your system. Use this to keep user info current.
- 11 Capability
Add points
Give a subscriber extra points for a specific action. This is how you reward high-value behavior.
- 12 Capability
Add subscriber
Put a new person into a referral campaign. You can do this quickly via natural language.
Set up in minutes
One URL. Then ask ReferralHero to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use ReferralHero from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_ePLlmy4BVCx8LOg3slIHts6pJKt2dvuI0gEpZzZU/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it ReferralHero, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable ReferralHero for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_ePLlmy4BVCx8LOg3slIHts6pJKt2dvuI0gEpZzZU/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the ReferralHero URL.
- Step 03
Save and start
Save the connection and enable ReferralHero in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"referralhero": {
"url": "https://edge.vinkius.com/vk_preview_ePLlmy4BVCx8LOg3slIHts6pJKt2dvuI0gEpZzZU/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using ReferralHero
Open Agent mode in chat and ask: "Using ReferralHero, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"referralhero": {
"url": "https://edge.vinkius.com/vk_preview_ePLlmy4BVCx8LOg3slIHts6pJKt2dvuI0gEpZzZU/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using ReferralHero
Ask Copilot: "Using ReferralHero, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"referralhero": {
"url": "https://edge.vinkius.com/vk_preview_ePLlmy4BVCx8LOg3slIHts6pJKt2dvuI0gEpZzZU/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using ReferralHero
Open Cascade and ask: "Using ReferralHero, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"referralhero": {
"url": "https://edge.vinkius.com/vk_preview_ePLlmy4BVCx8LOg3slIHts6pJKt2dvuI0gEpZzZU/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using ReferralHero
Ask Cline: "Using ReferralHero, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add referralhero --transport http "https://edge.vinkius.com/vk_preview_ePLlmy4BVCx8LOg3slIHts6pJKt2dvuI0gEpZzZU/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using ReferralHero
Ask Claude: "Using ReferralHero, show me...". 12 tools are ready
Where the request belongs
Work ReferralHero can move forward.
Growth marketers and founders who are tired of manual data entry. It's for the person who needs to see who's winning a referral contest right now without opening a spreadsheet.
Growth Marketer
Monitoring viral coefficients and checking reward eligibility during a live launch.
Marketing Ops Manager
Batch updating subscriber points or auditing transaction logs for the finance team.
Customer Success Lead
Looking up specific subscriber profiles to troubleshoot reward issues for high-value users.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsReferly
Automate affiliate programs via Referly. manage partners, track conversions, and monitor workflows directly.
Platform.ly
Grow your business with marketing automation, CRM, and analytics connected in one platform that shows what drives revenue.
Kit (ConvertKit)
Automate your creator marketing. manage subscribers, tags, and forms via AI.
Odicci
Launch interactive marketing campaigns with gamification elements like spin wheels, quizzes, and scratch cards that capture leads.
Viral Loops
Manage referral campaigns, participants, milestones, and rewards via Viral Loops API.
Referrizer
Automate referral marketing and loyalty via Referrizer. manage contacts, referrals, and rewards directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep ReferralHero connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about ReferralHero.
The practical details behind the request, access and result.
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 capabilities.
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 capabilities for you.
Can my AI automatically find the details and points for a specific subscriber by providing their ID?
Yes! Use the get_subscriber capability 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.
One connection away
Give your agent a direct line to ReferralHero.
Connect ReferralHero once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available