@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:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"refgrow": {
"command": "npx",
"args": ["-y", "@refgrow/mcp"],
"env": {
"REFGROW_API_KEY": "rgk_your_api_key_here"
}
}
}
}
Or if installed globally / from source:
{
"mcpServers": {
"refgrow": {
"command": "node",
"args": ["/path/to/packages/mcp-server/dist/index.js"],
"env": {
"REFGROW_API_KEY": "rgk_your_api_key_here"
}
}
}
}
Usage with Cursor
In Cursor settings, add an MCP server with:
- Name: refgrow
- Command:
npx -y @refgrow/mcp - Environment:
REFGROW_API_KEY=rgk_your_api_key_here
Or add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"refgrow": {
"command": "npx",
"args": ["-y", "@refgrow/mcp"],
"env": {
"REFGROW_API_KEY": "rgk_your_api_key_here"
}
}
}
}
Usage with Claude Code
Add to your project's .mcp.json:
{
"mcpServers": {
"refgrow": {
"command": "npx",
"args": ["-y", "@refgrow/mcp"],
"env": {
"REFGROW_API_KEY": "rgk_your_api_key_here"
}
}
}
}
Available Tools
Affiliates
| Tool | Description |
|---|---|
list_affiliates | List all affiliates with stats (clicks, signups, purchases, earnings) |
get_affiliate_details | Get details for a specific affiliate by email |
create_affiliate | Create a new affiliate with optional custom referral code |
update_affiliate | Update affiliate email, referral code, status, or partner slug |
delete_affiliate | Remove an affiliate from the project |
Referrals
| Tool | Description |
|---|---|
list_referrals | List referred users, filterable by affiliate or status |
get_referral_details | Get details for a specific referred user by email |
create_referral | Manually create a referred user record |
Conversions
| Tool | Description |
|---|---|
list_conversions | List conversions with filters for type, affiliate, date range, paid status |
get_conversion | Get a specific conversion by ID |
create_conversion | Create a conversion (signup/purchase) with auto-commission calculation |
update_conversion | Update conversion details or mark as paid |
delete_conversion | Delete a conversion record |
Coupons
| Tool | Description |
|---|---|
list_coupons | List coupon codes with affiliate info |
get_coupon | Get a specific coupon by ID |
create_coupon | Create a coupon linked to an affiliate (with optional Stripe/LemonSqueezy IDs) |
update_coupon | Update coupon details |
delete_coupon | Delete a coupon (also removes from Stripe if linked) |
Example Conversations
Once connected, you can ask your AI agent things like:
- "Show me all active affiliates and their earnings"
- "Create a new affiliate for partner@example.com with referral code PARTNER2025"
- "List all unpaid conversions from the last 30 days"
- "How many signups did we get through affiliate referrals this month?"
- "Create a coupon code SAVE20 linked to affiliate ID 42"
- "Mark conversion #123 as paid"
- "Deactivate the affiliate with email old-partner@example.com"
Development
# Install dependencies
npm install
# Build
npm run build
# Watch mode for development
npm run dev
# Run the server (requires REFGROW_API_KEY env var)
REFGROW_API_KEY=rgk_your_key npm start
Documentation
Full setup guide with examples and troubleshooting: https://refgrow.com/docs/mcp-server
REST API reference (for direct HTTP integration): https://refgrow.com/docs/api-reference
License
MIT