Refgrow

io.github.refgrowPublished by GitHub account refgrowv1.3.0Updated Oct 29, 2026

Model Context Protocol server for Refgrow affiliate program management API

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Wraps the Refgrow affiliate program API so an assistant can manage affiliates, referrals, conversions and coupons from chat.

What you can do
  • List, inspect, create, update and delete affiliates, including referral codes and partner slugs
  • List and look up referred users, and manually create referral records
  • List, view, create, update and delete conversions, including marking them paid
  • List, view, create, update and delete coupon codes, optionally linked to an affiliate and to Stripe or LemonSqueezy
When to use it
Useful when you run an affiliate program on Refgrow and want to query earnings, signups and unpaid conversions, or make routine changes such as adding a partner, creating a coupon or marking a conversion paid, without opening the dashboard.
Requirements
Runs locally over stdio via the npm package @refgrow/mcp, so Node.js 18+ is needed. A Refgrow account and an API key (starting with rgk_) supplied in the REFGROW_API_KEY environment variable; REFGROW_API_URL optionally overrides the API base URL. Network access to the Refgrow API.
Before you install
The API key in REFGROW_API_KEY grants access to your affiliate program data and is shown only once when generated. Tools can create, update and delete affiliates, conversions and coupons, and can mark conversions as paid; deleting a coupon may also remove it from Stripe. Confirm destructive or payment-related actions before letting an assistant run them.

Installation

In SourceWeft

  1. Open Refgrow in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
npm install @refgrow/mcp

Or clone and build from source:

bash
git clone https://github.com/refgrow/refgrow-mcp.gitcd refgrow-mcpnpm installnpm run build

Configuration

The server requires two environment variables:

VariableRequiredDefaultDescription
REFGROW_API_KEYYes--Your Refgrow API key (starts with rgk_)
REFGROW_API_URLNohttps://refgrow.comBase URL of your Refgrow instance

Getting an API Key

  1. Log in to Refgrow
  2. Go to your project settings
  3. Scroll to the API Keys section
  4. Click Generate API Key
  5. 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

json
{  "mcpServers": {    "refgrow": {      "command": "npx",      "args": ["-y", "@refgrow/mcp"],      "env": {        "REFGROW_API_KEY": "rgk_your_api_key_here"      }    }  }}

Or if installed globally / from source:

json
{  "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:

json
{  "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:

json
{  "mcpServers": {    "refgrow": {      "command": "npx",      "args": ["-y", "@refgrow/mcp"],      "env": {        "REFGROW_API_KEY": "rgk_your_api_key_here"      }    }  }}

Available Tools

Affiliates

ToolDescription
list_affiliatesList all affiliates with stats (clicks, signups, purchases, earnings)
get_affiliate_detailsGet details for a specific affiliate by email
create_affiliateCreate a new affiliate with optional custom referral code
update_affiliateUpdate affiliate email, referral code, status, or partner slug
delete_affiliateRemove an affiliate from the project

Referrals

ToolDescription
list_referralsList referred users, filterable by affiliate or status
get_referral_detailsGet details for a specific referred user by email
create_referralManually create a referred user record

Conversions

ToolDescription
list_conversionsList conversions with filters for type, affiliate, date range, paid status
get_conversionGet a specific conversion by ID
create_conversionCreate a conversion (signup/purchase) with auto-commission calculation
update_conversionUpdate conversion details or mark as paid
delete_conversionDelete a conversion record

Coupons

ToolDescription
list_couponsList coupon codes with affiliate info
get_couponGet a specific coupon by ID
create_couponCreate a coupon linked to an affiliate (with optional Stripe/LemonSqueezy IDs)
update_couponUpdate coupon details
delete_couponDelete 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 [email protected] 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 [email protected]"

Development

bash
# Install dependenciesnpm install
# Buildnpm run build
# Watch mode for developmentnpm 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

Source: README.md at commit 7b4fae2

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the server did not start.

Version history

2
  1. v1.3.0LatestOct 29, 2026
  2. v1.0.3Sep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.