Bring Referral Marketing
to Vercel AI SDK
Learn how to connect ReferralCandy to Vercel AI SDK 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 Vercel AI SDK?
The Vercel AI SDK gives every ReferralCandy tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 16 tools through Vinkius and stream results progressively to React, Svelte, or Vue components. works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
- —
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
- —
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime. same ReferralCandy integration everywhere
- —
Built-in streaming UI primitives let you display ReferralCandy tool results progressively in React, Svelte, or Vue components
- —
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
ReferralCandy in Vercel AI SDK
ReferralCandy and 3,400+ other MCP servers. One platform. One governance layer.
Teams that connect ReferralCandy to Vercel AI SDK 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 Vercel AI SDK
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 Vercel AI SDK 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 Vercel AI SDK
Every tool call from Vercel AI SDK 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 does the Vercel AI SDK connect to MCP servers?
Import createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.
Can I use MCP tools in Edge Functions?
Yes. The AI SDK is fully edge-compatible. MCP connections work on Vercel Edge Functions, Cloudflare Workers, and similar runtimes.
Does it support streaming tool results?
Yes. The SDK provides streaming primitives like useChat and streamText that handle tool calls and display results progressively in the UI.
createMCPClient is not a function
Install: npm install @ai-sdk/mcp