# Refersion MCP

> Refersion MCP manages your entire affiliate marketing program directly through conversation. List affiliates, track sales conversions instantly, and configure webhooks without touching the dashboard. It gives your agent full control over partner performance data and payouts.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** affiliate-marketing, conversion-tracking, partner-management, referral-program, marketing-analytics

## Description

Need to manage a complex affiliate network? Connect this Refersion MCP to any AI client—Claude, Cursor, or Windsurf—and handle all program tasks using natural conversation. You can instantly list every registered affiliate, grab detailed profiles by ID, or even register new partners. Need to credit someone for sales? Just tell your agent to create a conversion record, ensuring accurate payouts. It also lets you check existing webhook settings and set up new listeners so your systems get real-time updates on program activity. Because Vinkius hosts this MCP, you don't need separate credentials; just connect once and manage everything from one spot.

## Tools

### create_affiliate
Adds a brand new affiliate account to the program.

### create_conversion
Manually adds a sales conversion record and credits an affiliate's account.

### create_webhook
Sets up a new endpoint listener to receive real-time activity notifications.

### get_affiliate
Retrieves the full profile details for one specific affiliate using their ID number.

### get_conversion
Fetches all the metadata and details about a single recorded conversion event.

### list_affiliates
Returns a list of every affiliate currently registered in your program.

### list_conversions
Provides an overview and listing of recent conversion records.

### list_webhooks
Shows all the webhook listeners that are currently configured for your account.

## Prompt Examples

**Prompt:** 
```
List all my current affiliates in Refersion.
```

**Response:** 
```
I've retrieved your affiliate list. You have 12 active affiliates, including 'Sarah Jenkins' (ID: aff_882) and 'Tech Reviews Inc' (ID: aff_901). Would you like details on a specific one?
```

**Prompt:** 
```
Create a new conversion of 75.00 USD for affiliate ID aff_882.
```

**Response:** 
```
The conversion has been successfully recorded. A new entry for $75.00 USD has been credited to affiliate aff_882 (Sarah Jenkins).
```

**Prompt:** 
```
Show me all configured webhooks.
```

**Response:** 
```
You currently have 2 webhooks configured: one for 'New Affiliate' events pointing to your production server and another for 'New Conversion' events.
```

## Capabilities

### Manage Affiliate Roster
List all current partners or retrieve the detailed profile for a single affiliate using their unique ID.

### Process Sales Credits
Record new conversions immediately to credit affiliates for sales, or check records of past transactions.

### Configure Real-time Notifications
List existing webhooks or set up new listeners so your systems respond instantly when events happen in the affiliate program.

## Use Cases

### Handling a Payment Dispute
An affiliate claims they were paid incorrectly. Instead of digging through logs, you ask your agent to `get_conversion` details for the specific transaction ID. The agent pulls up all metadata instantly, letting you prove exactly when and how much was credited.

### Onboarding a New Partner
A new partner joins the program. You simply ask your agent to `create_affiliate` with their details. The agent handles the account creation, getting them into the system faster than any web form.

### System Integration Testing
Your development team needs to test a new payment flow. They use `list_webhooks` first to see what's running, then use `create_webhook` to simulate the endpoint they need for testing.

### End-of-Month Reporting
You need a summary of all sales. Instead of exporting and filtering reports, you ask your agent to `list_conversions`, getting a clean list of all recorded payouts in seconds.

## Benefits

- Stop manually checking dashboards. You can immediately list all affiliates using `list_affiliates` or check detailed profiles with `get_affiliate`, saving minutes every hour.
- Never lose track of payments. Use `create_conversion` to instantly credit an affiliate for a sale, ensuring your partners get paid fast without needing manual entry.
- Stay updated on events. You can list existing webhook configurations using `list_webhooks` and set up new listeners with `create_webhook`—all via chat.
- Better dispute resolution means less hassle. Use `get_conversion` or fetch full affiliate metadata to resolve payment disputes by reviewing detailed records instantly.
- Speed up onboarding. You can create brand new accounts using the `create_affiliate` tool, getting new partners registered and ready to sell in moments.

## How It Works

The bottom line is that you use natural language to make changes and get reports without logging into Refersion or running complex API calls.

1. Subscribe to this MCP and provide your Refersion Public Key and Secret Key.
2. Connect your AI agent (like Claude or Cursor) through Vinkius.
3. Tell your agent exactly what you need—for example, 'List all affiliates who signed up last month'—and the data appears instantly.

## Frequently Asked Questions

**How do I check if an affiliate exists using Refersion MCP?**
You use the `get_affiliate` tool. Give your agent the unique ID for that partner, and it instantly returns their profile details so you know if they're active or missing.

**Can I bulk-credit an affiliate using Refersion MCP?**
The `create_conversion` tool handles single records. If you need to credit multiple people, you must first use `list_affiliates` to gather all IDs and then prompt your agent to run the conversion for each one.

**What is the difference between list_conversions and get_conversion with Refersion MCP?**
`list_conversions` shows you a high-level overview of recent payouts. `get_conversion` lets you drill down to see every piece of metadata for one specific, past transaction.

**Do I need to use the Refersion MCP to set up webhooks?**
No, but this MCP makes it easy. You can run `list_webhooks` and then use `create_webhook` to manage all your listeners directly through conversation.

**What if I want to add a new affiliate using Refersion MCP?**
You simply ask your agent to run the `create_affiliate` tool. You provide the necessary details, and the account is created right away in the system.