Mcp
Connects Claude or other MCP clients directly to the Refgrow affiliate management API. You get tools to create and manage affiliates, track referrals and conversions, and handle coupon codes tied to partners. Useful if you're running an affiliate program and want to query stats, mark payouts as complete, or onboard new affiliates without leaving your editor or chat. Supports filtering conversions by date range or paid status, auto-calculating commissions, and syncing coupons with Stripe or LemonSqueezy. Requires a Refgrow API key from your project settings. Built for teams managing partner programs who'd rather ask "show me unpaid conversions this month" than click through dashboards.
- GitHub stars
- 2
- tools
- 18
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Oct 29, 2026
Tools
18 toolsPublic tool metadata for what this MCP can expose to an agent.
list_affiliatesList all affiliates with stats (clicks, signups, purchases, earnings)
List all affiliates with stats (clicks, signups, purchases, earnings)
No parameter schema in public metadata yet.
get_affiliate_detailsGet details for a specific affiliate by email
Get details for a specific affiliate by email
No parameter schema in public metadata yet.
create_affiliateCreate a new affiliate with optional custom referral code
Create a new affiliate with optional custom referral code
No parameter schema in public metadata yet.
update_affiliateUpdate affiliate email, referral code, status, or partner slug
Update affiliate email, referral code, status, or partner slug
No parameter schema in public metadata yet.
delete_affiliateRemove an affiliate from the project
Remove an affiliate from the project
No parameter schema in public metadata yet.
list_referralsList referred users, filterable by affiliate or status
List referred users, filterable by affiliate or status
No parameter schema in public metadata yet.
get_referral_detailsGet details for a specific referred user by email
Get details for a specific referred user by email
No parameter schema in public metadata yet.
create_referralManually create a referred user record
Manually create a referred user record
No parameter schema in public metadata yet.
list_conversionsList conversions with filters for type, affiliate, date range, paid status
List conversions with filters for type, affiliate, date range, paid status
No parameter schema in public metadata yet.
get_conversionGet a specific conversion by ID
Get a specific conversion by ID
No parameter schema in public metadata yet.
create_conversionCreate a conversion (signup/purchase) with auto-commission calculation
Create a conversion (signup/purchase) with auto-commission calculation
No parameter schema in public metadata yet.
update_conversionUpdate conversion details or mark as paid
Update conversion details or mark as paid
No parameter schema in public metadata yet.
delete_conversionDelete a conversion record
Delete a conversion record
No parameter schema in public metadata yet.
list_couponsList coupon codes with affiliate info
List coupon codes with affiliate info
No parameter schema in public metadata yet.
get_couponGet a specific coupon by ID
Get a specific coupon by ID
No parameter schema in public metadata yet.
create_couponCreate a coupon linked to an affiliate (with optional Stripe/LemonSqueezy IDs)
Create a coupon linked to an affiliate (with optional Stripe/LemonSqueezy IDs)
No parameter schema in public metadata yet.
update_couponUpdate coupon details
Update coupon details
No parameter schema in public metadata yet.
delete_couponDelete a coupon (also removes from Stripe if linked)
Delete a coupon (also removes from Stripe if linked)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
REFGROW_API_KEY*secretYour Refgrow API key (starts with rgk_)
REFGROW_API_URLRefgrow API base URL
Readme
@refgrow/mcp
A Model Context Protocol (MCP) server that wraps the Refgrow REST API. This allows AI agents -- Claude Desktop, Cursor, ChatGPT, and other MCP-compatible clients -- to manage your affiliate program directly.
Prerequisites
- Node.js 18+
- A Refgrow account with an API key (generated in project settings)
- API keys start with
rgk_
Installation
npm install @refgrow/mcp
Or clone and build from source:
git clone https://github.com/refgrow/refgrow-mcp.git
cd refgrow-mcp
npm install
npm run build
Configuration
The server requires two environment variables:
| Variable | Required | Default | Description |
|---|---|---|---|
REFGROW_API_KEY | Yes | -- | Your Refgrow API key (starts with rgk_) |
REFGROW_API_URL | No | https://refgrow.com | Base URL of your Refgrow instance |
Getting an API Key
- Log in to Refgrow
- Go to your project settings
- Scroll to the API Keys section
- Click Generate API Key
- Copy the key (it starts with
rgk_and is shown only once)
Usage with Claude Desktop
Add this to your Claude Desktop config file:
Details
- Repository
- github.com/refgrow/refgrow-mcp
- Package
@refgrow/mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active