# GrowSurf

Connect an agent to GrowSurf to manage referral and affiliate programs, handle participants, and inspect campaign analytics.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: growsurf
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/growsurf/growsurf-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/growsurf

## What it does

GrowSurf exposes REST API actions for program setup and participant management. An agent can configure rewards and tracking, work with webhooks, and retrieve campaign analytics. Guidance tools cover web and mobile integrations, with code examples available for several programming languages.

The server can create or edit campaigns, rewards, and program resources. It can also add participants, email them, record affiliate transactions, and capture a temporary preview of a draft program. Program deletion and reward fulfillment are outside its tool set.

Choose a remote HTTP connection or run the server locally over stdio. The local setup uses `GROWSURF_API_KEY` and `GROWSURF_CAMPAIGN_ID`, so both values are needed for that route. The full catalog has 63 tools; `--compact` selects 32.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.growsurf.com`
- Environment variables: `GROWSURF_API_KEY`, `GROWSURF_CAMPAIGN_ID`, `GROWSURF_UPLOAD_ALLOWED_ORIGINS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http growsurf https://mcp.growsurf.com
```

2. **Platform CLI**
```bash
claude mcp add --env GROWSURF_API_KEY=<GROWSURF_API_KEY> --env GROWSURF_CAMPAIGN_ID=<GROWSURF_CAMPAIGN_ID> --env GROWSURF_UPLOAD_ALLOWED_ORIGINS=<GROWSURF_UPLOAD_ALLOWED_ORIGINS> --transport stdio growsurf -- npx -y @growsurfteam/growsurf-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add growsurf --url https://mcp.growsurf.com
```

2. **Platform CLI**
```bash
codex mcp add growsurf --env GROWSURF_API_KEY=<GROWSURF_API_KEY> --env GROWSURF_CAMPAIGN_ID=<GROWSURF_CAMPAIGN_ID> --env GROWSURF_UPLOAD_ALLOWED_ORIGINS=<GROWSURF_UPLOAD_ALLOWED_ORIGINS> -- npx -y @growsurfteam/growsurf-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "growsurf": {
            "url": "https://mcp.growsurf.com"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "growsurf": {
            "command": "npx",
            "args": [
                "-y",
                "@growsurfteam/growsurf-mcp"
            ],
            "env": {
                "GROWSURF_API_KEY": "<GROWSURF_API_KEY>",
                "GROWSURF_CAMPAIGN_ID": "<GROWSURF_CAMPAIGN_ID>",
                "GROWSURF_UPLOAD_ALLOWED_ORIGINS": "<GROWSURF_UPLOAD_ALLOWED_ORIGINS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "growsurf": {
            "type": "http",
            "url": "https://mcp.growsurf.com"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "growsurf": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@growsurfteam/growsurf-mcp"
            ],
            "env": {
                "GROWSURF_API_KEY": "<GROWSURF_API_KEY>",
                "GROWSURF_CAMPAIGN_ID": "<GROWSURF_CAMPAIGN_ID>",
                "GROWSURF_UPLOAD_ALLOWED_ORIGINS": "<GROWSURF_UPLOAD_ALLOWED_ORIGINS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http growsurf https://mcp.growsurf.com
```

2. **Platform CLI**
```bash
gemini mcp add -e GROWSURF_API_KEY=<GROWSURF_API_KEY> -e GROWSURF_CAMPAIGN_ID=<GROWSURF_CAMPAIGN_ID> -e GROWSURF_UPLOAD_ALLOWED_ORIGINS=<GROWSURF_UPLOAD_ALLOWED_ORIGINS> growsurf npx -y @growsurfteam/growsurf-mcp
```
Replace <…> with your own values

## When to use it
- create a referral or affiliate program
- set up rewards and conversion tracking
- add participants and inspect their activity
- configure and test program webhooks
- retrieve campaign analytics

## Example prompts
- Create a referral program and suggest a reward structure.
- Add a participant to the campaign and show their activity.
- Check affiliate sale tracking and configure a webhook.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 397855
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 34011
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89674
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81191
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74577
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 90077

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md