Bring Referral Marketing
to Claude Code
Learn how to connect ReferralCandy to Claude Code and start using 16 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
What is the ReferralCandy MCP Server?
Give your AI agent full programmatic control over your ReferralCandy ecosystem. With 16 tools tailored for referral marketing, your agent can instantly track referrals by period, register attributed purchases, identify top advocates, monitor pending rewards, manage campaigns, and send referral invitations directly from your natural language workspace.
What you can do
- List and filter referrals by period
- Register purchases to trigger rewards
- Identify and manage top-performing advocates
- Monitor pending referral payouts
- Configure campaigns and send invites
- Access overall program statistics
How it works
1. Subscribe to this server 2. Enter your ReferralCandy API Keys (found in your developer settings) 3. Let your AI agents start managing your referral operations via VinkiusWho is it for?
Designed for marketing teams, e-commerce operators, and growth hackers who need instant, conversational access to affiliate and referral performance metrics.Built-in capabilities (16)
Verify connectivity
Get campaign details
Get referral details
Get advocate profile
Get program stats
Get top advocates
List campaigns
List sent invites
List pending rewards
List referred purchases
List all referrals
List referrals by period
List all advocates
List all rewards
Register a purchase
Send a referral invite
Why Claude Code?
Claude Code registers ReferralCandy as an MCP server in a single terminal command. Once connected, Claude Code discovers all 16 tools at runtime and can call them headlessly. ideal for CI/CD pipelines, cron jobs, and automated workflows where ReferralCandy data drives decisions without human intervention.
- —
Single-command setup:
claude mcp addregisters the server instantly. no config files to edit or applications to restart - —
Terminal-native workflow means MCP tools integrate seamlessly into shell scripts, CI/CD pipelines, and automated DevOps tasks
- —
Claude Code runs headlessly, enabling unattended batch processing using ReferralCandy tools in cron jobs or deployment scripts
- —
Built by the same team that created the MCP protocol, ensuring first-class compatibility and the fastest adoption of new protocol features
ReferralCandy in Claude Code
ReferralCandy and 3,400+ other MCP servers. One platform. One governance layer.
Teams that connect ReferralCandy to Claude Code through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 3,400+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for ReferralCandy in Claude Code
The ReferralCandy MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 16 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Claude Code only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
ReferralCandy for Claude Code
Every tool call from Claude Code to the ReferralCandy MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
Can my AI automatically register a new purchase to trigger a referral reward?
Yes! Use the register_purchase tool providing the buyer's email, order amount, and order ID. Your agent will send this data to ReferralCandy, triggering the referral attribution and payout flow instantly.
How do I easily find out who my best performing advocates are?
Simply ask the agent to run the get_top_referrers action. It will compile your highest-performing ambassadors ranked by total successful referrals and the total revenue they generated for your store.
Can I check if a specific customer has any pending referral rewards?
Absolutely. By using the list_pending_rewards tool and filtering by the customer's email, your agent can instantly fetch their reward status and payout timeline without you needing to open the dashboard.
How do I add an MCP server to Claude Code?
Run claude mcp add --transport http "" in your terminal. Claude Code registers the server and discovers all tools immediately.
Can Claude Code run MCP tools in headless mode?
Yes. Claude Code supports non-interactive execution, making it ideal for scripts, cron jobs, and CI/CD pipelines that need MCP tool access.
How do I list all connected MCP servers?
Run claude mcp in your terminal to see all registered servers and their status, or type /mcp inside an active Claude Code session.
Command not found: claude
Ensure Claude Code is installed globally: npm install -g @anthropic-ai/claude-code
Connection timeout
Check your internet connection and verify the Edge URL is reachable