Refgrow

io.github.refgrow由 GitHub 帳號 refgrow 發布v1.3.0更新於 Oct 29, 2026

Model Context Protocol server for Refgrow affiliate program management API

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

封裝 Refgrow 聯盟計畫 API，讓助理能在對話中管理聯盟夥伴、推薦、轉換與優惠券。

可以做什麼
  • 列出、檢視、建立、更新與刪除聯盟夥伴，包含推薦碼與合作夥伴代稱
  • 列出並查詢被推薦使用者，也可手動建立推薦紀錄
  • 列出、檢視、建立、更新與刪除轉換紀錄，包含標記為已付款
  • 列出、檢視、建立、更新與刪除優惠券，可連結聯盟夥伴及 Stripe 或 LemonSqueezy
適用情境
適合在 Refgrow 上經營聯盟計畫、想直接查詢收益、註冊量與未付款轉換，或完成新增夥伴、建立優惠券、標記轉換已付款等日常操作而不必開啟後台的情境。
執行需求
透過 npm 套件 @refgrow/mcp 以 stdio 在本機執行，需要 Node.js 18 以上。需要 Refgrow 帳號及以 rgk_ 開頭的 API 金鑰，透過環境變數 REFGROW_API_KEY 提供；REFGROW_API_URL 可覆寫 API 基礎位址。需能連線至 Refgrow API 的網路。
安裝前請注意
REFGROW_API_KEY 中的金鑰可存取你的聯盟計畫資料，且產生時僅顯示一次。工具可建立、更新與刪除聯盟夥伴、轉換與優惠券，並可將轉換標記為已付款；刪除優惠券可能同時從 Stripe 移除。執行刪除或付款相關操作前應先確認。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Refgrow，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 7b4fae2

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次，以列出其工具，但未能完成：伺服器未能啟動。

版本歷史

2
  1. v1.3.0最新Oct 29, 2026
  2. v1.0.3Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。