growsurf/growsurf-mcp

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#optional-connect-mcp
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#optional-connect-mcp.
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**:
- Create an account and get an API key with no existing credentials
- 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, get, and add participants
- Update a participant, email a participant, and get a participant's analytics and activity logs
- Trigger referral credit (for referral programs), with optional delayed award (1-90 days)
- Cancel a pending delayed referral trigger (for referral programs)
- Record affiliate sale/transaction (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 |