GrowSurf — Claude Code MCP server: features and setup
Connect an agent to GrowSurf to manage referral and affiliate programs, handle participants, and inspect campaign analytics.
claude mcp add --transport http growsurf https://mcp.growsurf.comWhat GrowSurf 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.
What it helps with
- 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 for the agent
- 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.
How to install GrowSurf
1Platform CLI: remote server
claude mcp add --transport http growsurf https://mcp.growsurf.com2Platform CLI
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-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add growsurf --url https://mcp.growsurf.com2Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"growsurf": {
"url": "https://mcp.growsurf.com"
}
}
}{
"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
Config file
{
"servers": {
"growsurf": {
"type": "http",
"url": "https://mcp.growsurf.com"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http growsurf https://mcp.growsurf.com2Platform CLI
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-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about GrowSurf
How do I install GrowSurf in Claude Code?
Connect the hosted server with claude mcp add --transport http growsurf https://mcp.growsurf.com.
What does GrowSurf do?
It gives an agent REST API tools for setting up GrowSurf programs, managing participants, and reading analytics.
Can I run GrowSurf locally?
Yes. The local stdio setup uses GROWSURF_API_KEY and GROWSURF_CAMPAIGN_ID; the alternative is a hosted HTTP connection.
