Refgrow MCP Server

by refgrow

295 downloads
Not rated
GitHub

About

MCP server for managing affiliate and referral programs. Create programs, track referrals, manage affiliates, process conversions, and handle payouts — all through AI assistants like Claude, Cursor, and ChatGPT.

Details

Author
refgrow
Downloads
295
Categories
Other, Developer Tools, AI, Marketing

- Create and configure affiliate programs with custom commission rates
- View, approve, and manage affiliates
- Track clicks, signups, and conversions in real-time
- Monitor revenue, commissions, and performance metrics
- Process affiliate payouts via PayPal or Wise

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Refgrow MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via MCP configuration using npx and set the required environment variable REFGROW_API_KEY. Obtain an API key by signing up at refgrow.com, creating a project, and generating a key in Project Settings → API. Once configured, available tools can be invoked by an MCP client.

list_affiliates

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

get_affiliate_details

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

create_affiliate

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

update_affiliate

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

delete_affiliate

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

list_referrals

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

get_referral_details

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

create_referral

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

list_conversions

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

get_conversion

Get details for a specific conversion by its ID.

create_conversion

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_conversion

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

delete_conversion

Delete a conversion record by its ID.

list_coupons

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

get_coupon

Get details for a specific coupon by its ID.

create_coupon

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_coupon

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

delete_coupon

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

get_project_stats

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_top_affiliates

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

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.

create_payout

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

AModel 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.

- Node.js 18+
- A Refgrow account with an API key (generated in project settings)
- API keys start withrgk_

git clone https://github.com/refgrow/refgrow-mcp.git cd refgrow-mcp npm install npm run build

The server requires two environment variables:
- Log in to
Refgrow
- Go to your project settings
- Scroll to theAPI Keyssection
- ClickGenerate API Key
- Copy the key (it starts withrgk_and is shown only once)

Add this to your Claude Desktop config file:

macOS:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "refgrow": { "command": "npx", "args": ["-y", "@refgrow/mcp"], "env": { "REFGROW_API_KEY": "rgk_your_api_key_here" } } } }
{ "mcpServers": { "refgrow": { "command": "node", "args": ["/path/to/packages/mcp-server/dist/index.js"], "env": { "REFGROW_API_KEY": "rgk_your_api_key_here" } } } }

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.jsonin your project root:

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

Once connected, you can ask your AI agent things like:

- "Show me all active affiliates and their earnings"
- "Create a new affiliate forpartner@example.comwith 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"

# 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

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

Chia Health MCP Server — Patient workflow integration for a licensed US telehealth platform. Browse GLP-1 medications (semaglutide, tirzepatide), peptide therapies (sermorelin, NAD+, glutathione), and longevity treatments. Check eligibility, complete intake, sign consents, and manage treatment plans. 30 tools, HIPAA-compliant. All prescriptions evaluated by licensed US healthcare providers and delivered from FDA-regulated pharmacies across 50 states + DC.

Broker + MCP server for last-bidder-wins games on Solana — agents register, auto-fund a Privy wallet, and bid via streamable HTTP

AI-powered no-code app builder with 17 MCP tools — create projects, generate pages from natural language, AI text/image generation (GPT, Claude, Gemini, 14+ models), page CRUD, workflow execution, publish & version control. SSE transport, API key auth.

An mcp server for your food ordering needs.

Agent-to-Agent handoff certification for multi-agent systems — validates context preservation, verifies agent capabilities before handoff, logs transfer chains, and ensures no data loss in agent orchestration.

Unified MCP & skill management gateway with progressive disclosure. Manages multiple MCP servers as Agent Apps, loading tool schemas on demand for 99% context token savings. Shared across Claude Code, Codex, OpenCode and more.

A collection of Model Context Protocol (MCP) servers for various tasks and integrations, supporting both Python and Node.js environments.

Open-souSecurely feeds real security refreshed rules into Cursor, Claude Code, and Windsurf — zero config, no API key.

Health intelligence MCP — access biomarkers, biological age, and personalized longevity action plans from your Aniva profile.

Real-time stock heatmaps and investment tools delivered as interactive React components.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.