🚀 nagoc-referly-mcp

Unlock the power of your affiliate network! This Model Context Protocol (MCP) server connects Claude Desktop directly to the Referly API.

With this integration, you can effortlessly manage your Affiliates, Referrals, Sales, Coupons, and Promotional Codes—just by chatting with Claude!

✅ Prerequisites

Before you begin, make sure you have the following ready to go:

1. Node.js: You need Node.js (v18 or higher) installed on your computer. You can get it here.
2. Claude Desktop: Installed and running on your Windows or Mac machine.
3. Referly API Key: You'll need an active API key from your Referly Dashboard.

🛠️ Installation & Configuration

It's super easy to get started! You just need to tell Claude Desktop to use this server.

1. Open your Claude Desktop configuration file:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add nagoc-referly to your mcpServers list based on your operating system:

For Windows:

{
  "mcpServers": {
    "nagoc-referly": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "nagoc-referly-mcp@latest"
      ],
      "env": {
        "REFERLY_API_KEY": "YOUR_REFERLY_API_KEY"
      }
    }
  }
}

For Mac:

{
  "mcpServers": {
    "nagoc-referly": {
      "command": "npx",
      "args": [
        "-y",
        "nagoc-referly-mcp@latest"
      ],
      "env": {
        "REFERLY_API_KEY": "YOUR_REFERLY_API_KEY"
      }
    }
  }
}

3. Restart Claude Desktop. That's it! Claude will automatically download and connect to your Referly account.

💬 Awesome Examples: How to Talk to Claude

Once configured, Claude becomes your personal Affiliate Marketing Assistant. Here are some examples of what you can ask:

1. View Your Data

"Claude, can you list all my current affiliates in Referly?"

"Show me my recent sales and let me know if any of them need to be updated."

"Retrieve the list of active promotional codes I have set up."

2. Create New Campaigns & Affiliates

"Create a new coupon in Referly for 20% off that lasts for 3 months."

"I just brought on a new partner. Please create a new affiliate profile for John Doe."

"Generate a new promotional code 'SUMMER25' linked to my summer coupon."

3. Update & Manage

"Update the referral status for referral ID xyz123 to approved."

"Delete the promotional code 'WINTER10', it's no longer active."

"Refund the sale with ID sale_987."

Because the tools are built to dynamically handle data, Claude knows how to structure your requests properly based on your natural language instructions!

Built with ❤️ by nagoc.work