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.

INSTANT PLUG AND PLAY

ReferralCandy MCP Server for Claude DesktopGive Claude Desktop instant access to 16 tools to Check Referralcandy Status, Get Campaign, Get Referral, and more

Name: ReferralCandy
Availability: InStock
Author: Vinkius

Built by Vinkius GDPR 16 Tools IDE

Claude Desktop is Anthropic's native application for interacting with Claude AI models on macOS and Windows. It was the first consumer application to ship with built-in MCP support, making it the reference implementation for the Model Context Protocol standard.

Use with Your AI Agent

Ask AI about this App Connector for Claude Desktop

Open in ChatGPT Open in Claude Open in Perplexity

The ReferralCandy app connector for Claude Desktop is a standout in the Marketing Automation category — giving your AI agent 16 tools to work with, ready to go from day one.

Vinkius delivers Streamable HTTP and SSE to any MCP client

RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install ReferralCandy and 3,400+ MCP Servers from a single visual interface.

Download Free Open SourceNo signup required

Classic Setup·json

{
  "mcpServers": {
    "referralcandy": {
      // Your Vinkius token. get it at cloud.vinkius.com
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* 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

About 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.

Claude Desktop is the definitive way to connect ReferralCandy to your AI workflow. Add Vinkius Edge URL to your config, restart the app, and Claude immediately exposes all 16 tools in the chat interface. ask a question, Claude calls the right tool, and you see the answer. Zero code, zero context switching.

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

Who is it for?

Designed for marketing teams, e-commerce operators, and growth hackers who need instant, conversational access to affiliate and referral performance metrics.

The ReferralCandy MCP Server exposes 16 tools through the Vinkius. Connect it to Claude Desktop in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

All 16 ReferralCandy tools available for Claude Desktop

When Claude Desktop connects to ReferralCandy through Vinkius, your AI agent gets direct access to every tool listed below — spanning referral-marketing, affiliates, loyalty, and more. Every call is secured with network, filesystem, subprocess, and code evaluation entitlements inside a sandboxed runtime. Beyond a simple connection, you get a full AI Gateway with real-time visibility into agent activity, enterprise governance, and optimized token usage.

check_referralcandy_status

Verify connectivity

get_campaign

Get campaign details

get_referral

Get referral details

get_referrer

Get advocate profile

get_stats

Get program stats

get_top_referrers

Get top advocates

list_campaigns

List campaigns

list_invites

List sent invites

list_pending_rewards

List pending rewards

list_purchases

List referred purchases

list_referrals

List all referrals

list_referrals_by_period

List referrals by period

list_referrers

List all advocates

list_rewards

List all rewards

register_purchase

send_invite

Send a referral invite

Connect ReferralCandy to Claude Desktop via MCP

Follow these steps to wire ReferralCandy into Claude Desktop. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.

Open Claude Desktop Settings

Go to Settings → Developer → Edit Config to open claude_desktop_config.json

Add the MCP Server

Paste the configuration above into the mcpServers section

Restart Claude Desktop

Close and reopen Claude Desktop to load the new server

Start using ReferralCandy

Look for the 🔌 icon in the chat. your 16 tools are now available

Why Use Claude Desktop with the ReferralCandy MCP Server

Claude Desktop by Anthropic provides unique advantages when paired with ReferralCandy through the Model Context Protocol.

Claude Desktop is the reference MCP client. it was designed alongside the protocol itself, ensuring the most complete and stable MCP implementation available

Zero-code configuration: add a server URL to a JSON file and Claude instantly discovers and exposes all available tools in the chat interface

Claude's extended thinking capability lets it reason through multi-step tool usage, chaining multiple API calls to answer complex questions

Enterprise-grade security with local config storage. your tokens never leave your machine, and connections go directly to Vinkius Edge network

ReferralCandy + Claude Desktop Use Cases

Practical scenarios where Claude Desktop combined with the ReferralCandy MCP Server delivers measurable value.

Interactive data exploration: ask Claude to query DNS records, look up WHOIS data, and cross-reference results in a single conversation

Ad-hoc security audits: type a domain name and let Claude enumerate subdomains, check DNS history, and flag configuration anomalies. all through natural language

Executive briefings: generate comprehensive domain intelligence reports by asking Claude to compile findings into a formatted summary

Learning and training: new team members can explore API capabilities conversationally without needing to read documentation

Example Prompts for ReferralCandy in Claude Desktop

Ready-to-use prompts you can give your Claude Desktop agent to start working with ReferralCandy immediately.

"Can you find the top referrers in my ReferralCandy program for the last month?"

"Register a purchase of $150.00 for order #90210 by customer@example.com."

"List all pending referral rewards that need to be processed this week."

Troubleshooting ReferralCandy MCP Server with Claude Desktop

Common issues when connecting ReferralCandy to Claude Desktop through the Vinkius, and how to resolve them.

Server not appearing after restart

Ensure the JSON is valid (no trailing commas). Check the file path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\\Claude\\ (Windows).

Authentication error

Verify your Vinkius token is correct. Go to cloud.vinkius.com to regenerate it if needed.

Tools not showing in chat

Click the 🔌 icon at the bottom of the chat input. If it shows 0 tools, the server may still be connecting. wait a few seconds.

ReferralCandy + Claude Desktop FAQ

Common questions about integrating ReferralCandy MCP Server with Claude Desktop.

How does Claude Desktop discover MCP tools?

When Claude Desktop starts, it reads the claude_desktop_config.json file and connects to each configured MCP server. It calls the tools/list endpoint to fetch the schema for every available tool, then surfaces them as clickable options in the chat interface via the 🔌 icon.

What happens if the MCP server is temporarily unavailable?

Claude Desktop handles disconnections gracefully. if the server is unreachable at startup, the tools simply won't appear. Once the server becomes available again, restarting Claude Desktop will re-establish the connection. There is no timeout penalty or error loop.

Can I connect multiple MCP servers simultaneously?

Yes. You can add as many servers as you need in the mcpServers section of the config file. Each server appears as a separate tool provider, and Claude can use tools from multiple servers in a single conversation turn.

Is there a limit on the number of tools per server?

Claude Desktop can handle hundreds of tools per server. However, for optimal LLM performance, Vinkius servers are designed to expose focused, well-documented tool sets rather than overwhelming the model with too many options.

Does Claude Desktop support Streamable HTTP transport?

Yes. Claude Desktop supports both SSE (Server-Sent Events) and the newer Streamable HTTP transport that Vinkius uses. Simply provide the server URL. Claude auto-negotiates the transport protocol.