GrowSurf

Name: GrowSurf
Author: growsurf

by growsurfversion 0.19.28i★ –iComputer or cloud

Registry namecom.growsurf/growsurf

Install

Overview

Description from the maker (original English)

Build and manage GrowSurf referral and affiliate programs through AI assistants.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, Streamable HTTP
Category: Other
You need to fill in: GROWSURF_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 3 of 3 passed
Runs on the maker’s server: what you ask it goes through their server.
You fill in yourself: GROWSURF_API_KEY, GROWSURF_CAMPAIGN_ID, GROWSURF_UPLOAD_ALLOWED_ORIGINS

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://mcp.growsurf.com

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "growsurf": {
      "command": "npx",
      "args": [
        "-y",
        "@growsurfteam/growsurf-mcp"
      ],
      "env": {
        "GROWSURF_API_KEY": "your-value",
        "GROWSURF_CAMPAIGN_ID": "your-value",
        "GROWSURF_UPLOAD_ALLOWED_ORIGINS": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add --transport http growsurf https://mcp.growsurf.com

Or run it on your computer

claude mcp add growsurf --env GROWSURF_API_KEY=your-value --env GROWSURF_CAMPAIGN_ID=your-value --env GROWSURF_UPLOAD_ALLOWED_ORIGINS=your-value -- npx -y @growsurfteam/growsurf-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "growsurf": {
      "url": "https://mcp.growsurf.com"
    }
  }
}

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "growsurf": {
      "command": "npx",
      "args": [
        "-y",
        "@growsurfteam/growsurf-mcp"
      ],
      "env": {
        "GROWSURF_API_KEY": "your-value",
        "GROWSURF_CAMPAIGN_ID": "your-value",
        "GROWSURF_UPLOAD_ALLOWED_ORIGINS": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "growsurf": {
      "type": "http",
      "url": "https://mcp.growsurf.com"
    }
  }
}

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "growsurf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@growsurfteam/growsurf-mcp"
      ],
      "env": {
        "GROWSURF_API_KEY": "your-value",
        "GROWSURF_CAMPAIGN_ID": "your-value",
        "GROWSURF_UPLOAD_ALLOWED_ORIGINS": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://mcp.growsurf.com

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

GROWSURF_API_KEY secret env
A GrowSurf API key with access to the programs and actions you want to use.
GROWSURF_CAMPAIGN_ID env
The default GrowSurf program ID for program-scoped tools.
GROWSURF_UPLOAD_ALLOWED_ORIGINS env
A comma-separated allowlist of exact HTTPS origins accepted from GrowSurf FILE Resource upload tickets.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

The server asks you to sign in before it lists its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain growsurf.com (the registry checks domain ownership)
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
✓ Pass
Endpoint responds
Responded in 187 ms (HTTP 401)
✓ Pass
Sign-in with OAuth
Declares OAuth sign-in, so your AI app can take you to log in
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Otheri

More stars than 0% of the other 32441 servers in this category
Published to the registry more recently than 93% of the other 32441 servers in this category
Basic checks equal to or better than 100% of the other 32441 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is GrowSurf safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: GROWSURF_API_KEY

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.19.28) reached the registry 2 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Intervals MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated yesterday

Install

Intervals MCP

by ljcl

Remote MCP server for intervals.icu run data and analysis

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

GrowSurf MCP Server

The official GrowSurf command-line interface (CLI) and open-source Model Context Protocol (MCP) server for implementing GrowSurf referral and affiliate programs with guided steps and safe REST API wrappers.

Connect it to an AI agent and, in plain language, the agent can create a referral or affiliate program, configure rewards, install tracking, add and manage participants, and read analytics, all backed by the GrowSurf REST API.

MCP is optional. Any action-capable agent that can send HTTPS requests can start with GrowSurf's client-neutral REST workflow at https://growsurf.com/agent-start.md.

Learn more about GrowSurf at https://growsurf.com
Start with direct REST at https://growsurf.com/agent-start.md
Read the OpenAPI contract at https://growsurf.com/openapi.json
Read the Arazzo workflow at https://growsurf.com/arazzo.yaml
Learn about optional MCP setup at https://docs.growsurf.com/build-with-ai#connect-the-mcp-server

Who is this for

This MCP server is for:

Developers using MCP-compatible tools (Claude Code, Codex, Cursor, Copilot, and other MCP clients)
Teams that want guided, AI-assisted GrowSurf integrations

This MCP server is NOT for:

Browser-only users who want a local stdio install. ChatGPT web and Claude.ai use the hosted remote connector at https://mcp.growsurf.com. Claude Desktop can use either the local stdio server or the hosted connector. See the full client list and setup at https://docs.growsurf.com/build-with-ai#connect-the-mcp-server.

What you get

Guided Integration:
Universal Code install
Native iOS/Android and React Native SDK implementation guidance
Native GrowSurf Window guidance
Signup flow
Qualifying action flow
Affiliate sale / transaction tracking
Webhooks
Agent Recipes:
MCP prompts for creating referral programs, creating affiliate programs, advising on program design, troubleshooting referral tracking, embedding the widget, listing and fetching programs and participants, configuring rewards, wiring webhooks, and reading analytics
Prompts use details from your conversation and ask only for missing information needed for the next step. No form inputs are needed. Existing prompt names and direct arguments remain supported.
Installable Agent Skill bundle at skills/growsurf-agent-toolkit
Steering to review starter Design, Emails, Options, Installation, rewards, and GrowSurf Window content before patching
One-shot program-creation eval prompts and acceptance checks for starter content and configuration review
Happy‑Path REST API Wrappers:
Read and rename the bound team, request team verification, and resend the team owner's verification email
List and get campaigns
Get campaign analytics (totals, time series, email metrics, participant engagement activity, and activation cohorts)
Create, update, and clone programs (campaigns)
List, create, update, and delete campaign rewards
List, create, update, and delete Program Resources, including a safe one-time FILE preparation flow
Get/update Design, Emails, Options, and Installation config
Capture temporary GrowSurf preview screenshots so the user can see a draft program
List, create, update, delete, and test program webhooks
List the program's integrations and get a dashboard link to connect one
List, get, add, and bulk delete participants
Update a participant, email a participant, and get a participant's analytics and activity logs
Get a participant's payout-destination status and ask them to confirm a payout destination
Trigger referral credit (for referral programs), with optional delayed award (1-90 days)
Cancel a pending delayed referral trigger (for referral programs)
Record affiliate sales/transactions and their refunds or chargebacks (for affiliate programs)
Create mobile participant tokens for signed-in native app users
Official API Library Snippets:
TypeScript
Python
PHP
Ruby
Java
Helpers:
Compute participant auto-auth HMAC hash
Normalize webhook payloads
Generate best‑effort idempotency keys for webhook deduplication

Choosing a tool

Use program and participant tools to read or change records. Guidance tools return advice or code for you to apply:

Task	Tool
Choose a program design and reward structure	`growsurf_program_design_advisor`
Plan a web integration	`growsurf_integration_guide`
Get browser JavaScript examples	`growsurf_client_snippets`
Get one embeddable element's HTML	`growsurf_embeddable_element_snippet`
Generate page-level participant auto authentication code	`growsurf_grsf_config_snippet`
Get backend REST API library examples	`growsurf_api_library_snippets`
Integrate a native iOS, Android, or React Native app	`growsurf_mobile_sdk_guide`
Diagnose a program problem	`growsurf_troubleshoot_referral_tracking`
Generate checks for an agent's program-creation workflow	`growsurf_agent_program_creation_eval`

Published tool names and fields use campaign for a program, including campaignId. These identifiers remain supported. Display titles use program terminology; Campaign Reward remains the name for a reward configuration.

To delete one participant, pass one ID or email in participants to growsurf_bulk_delete_participants. The same permanent-deletion warnings apply. A separate single-participant tool is not needed. Program deletion and explicit reward fulfillment are outside this MCP tool set; completing a program is not deletion, and configuring a reward is not proof that it was delivered.

Optional compact connection

The default connection lists all 66 tools. Add --compact to select 32 tools for program setup, installation, participant management, referral tracking, rewards, and analytics. Your credential permissions can reduce the visible set further.

npx -y @growsurfteam/growsurf-mcp --compact

In a stdio client configuration, append "--compact" to the package's args array. Server integrations can call createGrowSurfMcpServer({ toolSurface: "compact" }). Omit the option to keep the full catalog.

Compact combines related guidance and settings tools:

Tool	Selection	Arguments
`growsurf_get_guidance`	`topic`: `integration`, `browser`, `api_libraries`, `mobile_sdk`, `embeddable_element`, `participant_auto_auth`, or `program_creation_checks`	Put the selected guide's existing arguments under `input`. Use `{}` for defaults.
`growsurf_get_program_settings`	`section`: `design`, `emails`, `options`, or `installation`	Put `campaignId` under `input`, or use the configured default.
`growsurf_update_program_settings`	The same `section` values	Put `campaignId` and the `fields` patch under `input`. Read the section first.

For example, read a program's installation settings:

"name": "growsurf_get_program_settings", "arguments": { "section": "installation", "input": { "campaignId": "YOUR_PROGRAM_ID" } } }

Program recommendations and troubleshooting keep their own tools. Participant reads, updates, deletion, referral actions, and sale or refund actions remain separate. Compact prompts, resources, guidance, and proposed configuration calls use the compact tool names and arguments.

Use the full connection for team administration, program cloning, participant resources, custom domains, webhook creation/updates/deletion/tests, participant emails, payout destinations, and webhook normalization. Remove --compact and reconnect. These operations remain available with their existing contracts on the full connection; compact rejects calls to tools outside its catalog. The tool-selection table above describes the full connection.

Requirements

Node.js 22+
A GrowSurf account for hosted OAuth. Sign up at https://app.growsurf.com.
A GrowSurf API key for local stdio setup or manual API-key remote setup. Create one in the GrowSurf dashboard after you sign up. A scoped key works as long as it has access to the tools and programs you want the agent to use.
A campaign (program) ID for campaign-scoped tools. Set GROWSURF_CAMPAIGN_ID as the default, pass a campaignId argument to target a specific program, or call growsurf_list_campaigns to find available programs. For a newly created program, pass the id returned by growsurf_create_campaign to the other tools.
Static guidance/snippet tools can run without credentials
Team-level tools do not need a campaign ID.
Every listed tool publishes standard MCP read-only, destructive, idempotent, and open-world safety hints. Scoped business actions stay available; API-key rotation is intentionally not an MCP tool. Rotate keys in GrowSurf Settings or through a direct REST/SDK client.

Official CLI

The npm package installs the growsurf-mcp command. Run it without a global install:

npx -y @growsurfteam/growsurf-mcp

The CLI starts GrowSurf's local stdio MCP server. Set GROWSURF_API_KEY for API-backed actions and GROWSURF_CAMPAIGN_ID for a default program. Public developer resources and static integration guidance work without credentials.

Inspect the installed command without starting the stdio server:

npx -y @growsurfteam/growsurf-mcp --help

npx -y @growsurfteam/growsurf-mcp --version

Supported MCP Hosts

For an MCP-compatible host, use GrowSurf's hosted OAuth endpoint at https://mcp.growsurf.com when the host supports remote Streamable HTTP with OAuth. Use the local npx server when the host needs a stdio process or manual API-key setup. No GrowSurf account yet? Sign up at https://app.growsurf.com and create an API key in the dashboard, or connect to https://mcp.growsurf.com and sign in with OAuth.

The GrowSurf MCP server works with any MCP-compatible host. The examples below cover a few config-based and CLI hosts. For the complete, current list of supported clients (including ChatGPT web, Claude.ai, Claude Desktop, GitHub Copilot, Gemini CLI, Devin Desktop, and Cline) with step-by-step setup, see https://docs.growsurf.com/build-with-ai#connect-the-mcp-server.

Cursor
Claude Code (CLI-based)
Antigravity
Codex (CLI-based)

Cursor

Open or create Cursor's global MCP configuration at ~/.cursor/mcp.json.
Add a server named growsurf with the hosted OAuth endpoint:

"mcpServers": { "growsurf": { "type": "http", "url": "https://mcp.growsurf.com" } } }

For local stdio instead, use:

"mcpServers": { "growsurf": { "command": "npx", "args": ["-y", "@growsurfteam/growsurf-mcp"], "env": { "GROWSURF_API_KEY": "YOUR_API_KEY", "GROWSURF_CAMPAIGN_ID": "YOUR_CAMPAIGN_ID" } } } }

Claude Code (CLI-based)

Open your terminal and connect Claude Code to the hosted OAuth endpoint:

claude mcp add --transport http --scope user growsurf https://mcp.growsurf.com

claude mcp login growsurf

For local stdio instead, install the server directly into Claude Code:

claude mcp add growsurf \

-e GROWSURF_API_KEY=your_api_key \ -e GROWSURF_CAMPAIGN_ID=your_campaign_id \ -- npx -y @growsurfteam/growsurf-mcp

Antigravity

Open Antigravity.
Click the … menu in the panel to the right and select MCP Servers.
Click Manage MCP Servers > View raw config.
Recommended: in the mcp_config.json file, add the hos

Only the beginning is shown; read the rest in the repo

GrowSurf

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Intervals MCP

README from the maker

GrowSurf MCP Server

Who is this for

What you get

Choosing a tool

Optional compact connection

Requirements

Official CLI

Supported MCP Hosts

Cursor

Claude Code (CLI-based)

Antigravity