Refgrow MCP Server

List all affiliates in your Refgrow project with their stats (clicks, signups, purchases, earnings). Supports filtering by status and pagination.

Get detailed information about a specific affiliate by their email address, including click count, signups, purchases, and earnings.

Create a new affiliate in your Refgrow project. An affiliate receives a unique referral code and can start referring customers.

Update an existing affiliate's details such as email, referral code, status, or partner slug.

Delete an affiliate from your project. This also removes their associated referral data.

List referred users (signups tracked through affiliate links). Filter by affiliate or conversion status. Shows which affiliate referred each user.

Get details for a specific referred user by their email address.

Manually create a referred user record, optionally linking them to a specific affiliate.

List conversions (signups and purchases) tracked in your affiliate program. Filter by type, affiliate, date range, or paid status.

Get details for a specific conversion by its ID.

Manually create a conversion (signup or purchase). For purchases, the commission is auto-calculated from project settings if value is not provided. You can identify the affiliate by ID or referral code.

Update a conversion's details. Commonly used to mark a conversion as paid or update its value.

Delete a conversion record by its ID.

List coupon codes associated with affiliates in your project. Filter by status, affiliate, or coupon code search.

Get details for a specific coupon by its ID.

Create a new coupon code linked to an affiliate. Optionally tie it to a Stripe coupon ID or LemonSqueezy discount code for automatic attribution.

Update an existing coupon's code, linked affiliate, payment provider IDs, or status.

Delete a coupon by its ID. If linked to a Stripe coupon, it will also be deleted from Stripe.

Get program totals for a period: clicks, referrals, signups, purchases, revenue, commissions, new and earning affiliates, plus lifetime unpaid and paid-out figures. Totals are also broken down by currency; when mixed_currency is true the aggregate revenue and commissions mix units and should not be quoted as one number.

Get the best performing affiliates, ranked by lifetime earnings by default. Sort by unpaid balance, purchases or clicks instead when you need a payout list or a traffic ranking.

List payouts already recorded against the program, newest first, optionally for a single affiliate. Use get_top_affiliates with sort_by 'unpaid' to find who is still owed money; this tool shows what has been paid.

Record a commission payment you made outside Refgrow. This moves money in the program's books: it files the payment, subtracts the amount from the affiliate's unpaid balance and settles the conversions it covers. It does not send any money. Confirm the affiliate and the amount with the operator before calling it.