
MCP server for GrowSurf. Implement referral programs and affiliate programs with minimal dev time.
MCP server for GrowSurf. Implement referral programs and affiliate programs with minimal dev time.
·
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.
This MCP server is for:
This MCP server is NOT for:
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.skills/growsurf-agent-toolkitUse 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.
The default connection lists all 71 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 --compactIn 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, groups and bulk participant moves, 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.
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.The npm package installs the growsurf-mcp command. Run it without a global install:
npx -y @growsurfteam/growsurf-mcpThe 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 --versionFor 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/mcp.json.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"
}
}
}
}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 growsurfFor 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-mcpmcp_config.json file, add the hosted OAuth endpoint:{
"mcpServers": {
"growsurf": {
"serverUrl": "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"
}
}
}
}Recommended: connect Codex to the hosted OAuth endpoint:
codex mcp add growsurf --url https://mcp.growsurf.com
codex mcp login growsurfOr create or edit ~/.codex/config.toml:
[mcp_servers.growsurf]
url = "https://mcp.growsurf.com"For local stdio instead, add the following:
[mcp_servers.growsurf]
command = "npx"
args = ["-y", "@growsurfteam/growsurf-mcp"]
[mcp_servers.growsurf.env]
GROWSURF_API_KEY = "YOUR_API_KEY"
GROWSURF_CAMPAIGN_ID = "YOUR_CAMPAIGN_ID"Or configure local stdio from the CLI:
codex mcp add growsurf \
--env GROWSURF_API_KEY=YOUR_API_KEY \
--env GROWSURF_CAMPAIGN_ID=YOUR_CAMPAIGN_ID \
-- npx -y @growsurfteam/growsurf-mcpSet the following environment variables when running the MCP server:
GROWSURF_API_KEY (optional for startup; required for API-calling tools. Use a key with the scopes and program access those tools need)GROWSURF_CAMPAIGN_ID (optional; the default program for campaign-scoped tools. A tool's campaignId argument overrides it, so a single server can operate on any of your programs)GROWSURF_API_BASE_URL (optional; defaults to https://api.growsurf.com/v2. Useful for local or hosted MCP gateways that should call a different GrowSurf API origin)GROWSURF_UPLOAD_ALLOWED_ORIGINS (required only for FILE Resource uploads; a comma-separated private allowlist of exact HTTPS origins accepted from GrowSurf upload tickets. Wildcards and URL paths are rejected)The hash helper requires an explicit participantAuthSecret argument and never uses GROWSURF_PARTICIPANT_AUTH_SECRET. Use a test secret for MCP examples; authenticate users and sign with production secrets on your backend.
For webhooks, configure a signing secret and verify GrowSurf-Signature on your backend. GROWSURF_WEBHOOK_TOKEN is no longer used; keep secrets out of webhook URLs.
After publishing this package, customers can run:
npx @growsurfteam/growsurf-mcpFor local development in this repo:
npm install
npm run build
node dist/cli.jsEvery tool declares an MCP output schema and returns structuredContent, so hosts know each tool's result shape. REST tools return the API response (plus a JSON text block for older clients); the guidance and snippet tools return their markdown document under markdown.
Program, reward-configuration, options, and participant reads also include a rewardEvidence object in structuredContent. It records what this response establishes about approval policy and automatic fulfillment marking. Delivery remains unknown without the relevant fulfillment records. This assessment applies to this response only; combine it with other evidence. The API fields and original JSON text remain unchanged.
growsurf_integration_guide
Step-by-step guidance for implementing a GrowSurf referral or affiliate program.
growsurf_mobile_sdk_guide
Native iOS/Android or React Native SDK guidance for attribution, shareUrl, trackShare, and the native GrowSurf Window. Set platform to react_native for the React Native SDK.
growsurf_api_library_snippets
Official REST API library snippets for TypeScript, Python, PHP, Ruby, and Java.
growsurf_list_integrations
List every integration the program can connect, each with connected, enabled, autoDisabled, and the dashboard connectUrl. Check this before acting on an integration.
growsurf_get_integration_connect_link
Get a dashboard link that opens a specific integration's connect panel (Stripe, PayPal, Tango Card, Mailchimp, and many more). Hand it to the user when they want to connect one. The program is checked first, and the result reports whether the integration is already connected. Connecting happens in the dashboard, not through the API.
growsurf_program_design_advisor
Returns a short first draft by default. Set detail: "full" for the complete report, including reward, sharing, and integration figures. benchmarkFacts carries complete statements with each ratio's unit, median, quartiles, sample, and source. Quote these statements together so a referral ratio cannot be mistaken for the percentage of people who refer.
Recommend a qualifying action, reward structure, fulfillment path, safeguards, share channels, and integrations. The result includes markdown, a configurationPlan with exact tool arguments, and decisions with the qualifying action and unresolved customer choices. Call it before proposing rewards. Preserve the returned call shapes; the advisor and program-creation tools use different goal enums. Replace each <new-program-id> with the id returned by program creation. Drafts leave reward amounts and commission terms open until the customer chooses them; a budget is a limit, not an incentive. Set salesMotion to sales_led for demos or negotiated contracts, or self_service for direct purchases. When the host supplies insights, advice includes aggregate figures; without insights it uses documentation. Non-USD advice and budget comparisons omit dollar reward bands because the data mixes dollar currencies.
growsurf_troubleshoot_referral_tracking
Symptom-first diagnosis: referrals not credited, participant emails not sending, rewards not issued, participants not added, Universal Code not detected, integrations not syncing, Zapier errors, fraud flags, dashboard numbers that look wrong, and more. Returns the checks to run in order (with the read tool and field for each), the likely causes most common first, fixes, and doc links. Pass a symptom key, or a description that names the symptom.
growsurf_client_snippets
JavaScript SDK, GrowSurf Window, and embeddable examples. Includes a reminder to use a frontend design workflow when placing or styling embeddable UI.
growsurf_embeddable_element_snippet
HTML snippet for a specific GrowSurf embeddable element.
growsurf_grsf_config_snippet
<head> snippet for configuring window.grsfConfig and participant auto-auth.
growsurf_get_team
Fetch the team bound to the API key or OAuth connection, including its GrowSurf verification state.
growsurf_update_team
Update the bound team's display name.
growsurf_request_team_verification
Ask GrowSurf to verify the bound team, which is required before a program can email participants.
growsurf_resend_team_owner_verification_email
Resend the verification email to the bound team's owner without revealing their email address.
growsurf_get_campaign
Fetch campaign configuration.
growsurf_list_campaigns
List programs available to the credential. Use this to find a campaignId before calling campaign-scoped tools.
growsurf_get_campaign_analytics
Fetch program analytics, with optional per-period series, comparison, status, rate, email metrics via include=email, and participant activity-period engagement via include=engagement.
growsurf_get_campaign_activation_analytics
Fetch eligible-participant activation cohorts with a fixed 7- or 30-day observation window. Referral programs group by enrolledAsAdvocateAt; affiliate programs group by approvedAsAffiliateAt. Read coverageStartAt, state, and reason before interpreting zeroes or nulls.
growsurf_create_campaign
Create a new program (campaign) with type-appropriate starter content and optional inline rewards (only needs GROWSURF_API_KEY, not GROWSURF_CAMPAIGN_ID). Review the seeded Design, Emails, Options, Installation, rewards, and GrowSurf Window content before patching.
growsurf_agent_program_creation_eval
Generate one-shot program-creation eval prompts and acceptance checks for starter content, conservative rewards, configuration review, frontend install proof, and clean public copy.
growsurf_update_campaign
Update the program's identity and lifecycle: name, company branding, and status (only the fields you send are changed).
growsurf_clone_campaign
Clone the program into a new DRAFT program (integrations and credentials are not copied).
growsurf_list_campaign_rewards
List the program's configured rewards. Each reward's groupId names its group (null is Default). Pass groupId to list one group's rewards.
growsurf_create_campaign_reward
Create a campaign reward.
growsurf_update_campaign_reward
Update a campaign reward by its reward key.
growsurf_delete_campaign_reward
Delete a campaign reward by its reward key.
growsurf_list_campaign_groups / growsurf_create_campaign_group / growsurf_update_campaign_group / growsurf_delete_campaign_group
Manage groups, which give some participants a different reward list. A new group gets a copy of each active Default reward except Leaderboard rewards; change the copies with growsurf_update_campaign_reward. EMAIL and DOMAIN rules place new signups, and PARTICIPANT rules move existing participants. Deleting a group moves its members to Default.
growsurf_list_program_resources / growsurf_create_program_resource / growsurf_update_program_resource / growsurf_delete_program_resource
Manage ordered participant resources. LINK uses HTTPS and TEXT uses plain text.
growsurf_prepare_program_resource_file
Request a one-time ticket and upload an allowed file up to 10 MB to the exact host-allowlisted destination selected by GrowSurf. Pass the returned ticket and signed result unchanged to create/update. The tool accepts no upload URL or credential and never retries an upload.
growsurf_get_campaign_design / growsurf_update_campaign_design
Read or patch design configuration, including the Program Editor Design tab and payout-destination confirmation page copy.
growsurf_get_campaign_emails / growsurf_update_campaign_emails
Read or patch the Program Editor Emails tab config.
growsurf_get_campaign_options / growsurf_update_campaign_options
Read or patch the Program Editor Options tab config, including the program's languages.
growsurf_get_campaign_installation / growsurf_update_campaign_installation
Read or patch the Program Editor Installation tab config.
growsurf_get_campaign_custom_domain / growsurf_set_campaign_custom_domain / growsurf_verify_campaign_custom_domain / growsurf_remove_campaign_custom_domain
Serve the program's landing pages from your own domain. Set a hostname such as refer.example.com, add the CNAME record from the returned dnsRecord at your DNS provider, then verify to run a live DNS check. Setting a different domain replaces the current one, and the old domain stops loading right away. Removing the domain sends landing pages back to their GrowSurf URL.
growsurf_capture_referral_flow_screenshots
Capture temporary GrowSurf preview screenshots for the current program, after a draft is saved or when the user asks to see it. This returns the controlled referrer Window and referred-friend experience; use browser automation instead to prove the user's installed site.
growsurf_list_campaign_webhooks
List the program's webhooks (secrets are never returned).
growsurf_create_campaign_webhook
Add a webhook to the program (with events and a write-only signing secret).
growsurf_update_campaign_webhook
Update a webhook by id (primary for the program's primary webhook).
growsurf_delete_campaign_webhook
Remove a webhook by id.
growsurf_test_campaign_webhook
Send a live test event to a webhook using its stored URL and secret.
growsurf_add_participant
Add a participant (or referred participant) during signup.
growsurf_list_participants
List participants in the current program, paginated by nextId. Pass metadata (up to 3 keys) to return only participants whose metadata matches exactly, such as looking someone up by your own customer ID. Use this to find a participant ID before calling participant-scoped tools.
growsurf_get_participant
Fetch one participant by GrowSurf participant ID or email address.
growsurf_update_participant
Update a participant by ID or email (including internal notes, the participant's language, and their group with groupId).
growsurf_bulk_delete_participants — Check each row outcome. analyticsErasure.status: "pending" means analytics erasure is still pending; do not repeat successful rows.
Permanently delete up to 200 participants (by ID and/or email, mixed lists allowed) in one request, with per-row DELETED/NOT_FOUND/DUPLICATE/ERROR results. Irreversible. Successful rows lose participant access immediately; related record cleanup completes automatically, subject to required financial record retention.
growsurf_bulk_move_participants
Move up to 200 participants (by ID and/or email) to a group, or to Default with groupId: null, with per-row MOVED/NOT_FOUND/DUPLICATE/ERROR results. A move applies to new referrals only; rewards already earned keep their amounts.
growsurf_email_participant
Email a participant using a configured template or a free-form subject/body.
growsurf_get_participant_analytics
Fetch one participant's engagement, rank, share, affiliate revenue, commission, payout, optional email metrics, and covered first milestones. Use include=activation for milestones such as firstPortalViewedAt and firstShareChannel; add series for covered portalViews and shareActions. An unavailable null is unknown, not proof that the action never happened.
growsurf_get_participant_activity_logs
List a participant's activity logs (offset/limit paginated).
growsurf_trigger_referral
Trigger referral (for referral programs only). Optionally pass delayInDays (1-90) to hold the credit for N days before awarding it (e.g. to cover a refund window).
growsurf_cancel_delayed_referral
Cancel a pending delayed referral trigger before the delay elapses (e.g. on refund/cancellation).
growsurf_get_participant_payout_destination
Get a participant's payout-destination status across every provider enabled for the program (PayPal, Venmo, or Wise): per-provider status, confirmed payout email, legal recipient type, and repair reason.
growsurf_request_participant_payout_destination_confirmation
Ask a participant to confirm their payout destination for a provider — sends them a one-time confirmation link (only the participant can confirm).
growsurf_record_sale
Record affiliate sales or transactions (for affiliate programs only).
growsurf_refund_transaction
Record an amendment (refund, partial refund, or chargeback) against a recorded transaction; reverses or adjusts the referrer's commission (for affiliate programs only). The inverse of growsurf_record_sale.
growsurf_create_mobile_participant_token
Create or fetch a participant, then create a participant-scoped mobile SDK token for a signed-in mobile user.
growsurf_participant_auth_hash
Generate participant auto-auth HMAC hashes (to authenticate participants automatically).
growsurf_webhook_normalize
Normalize webhook payloads and generate idempotency keys (to deduplicate webhook deliveries).
GrowSurf webhooks notify your server when important referral or affiliate events occur, such as when new objects like participants, referrals, rewards, or transactions are created. Here are common use-cases:
Webhook handlers should be idempotent because the same event can arrive more than once. Store an idempotency key before changing anything in your system.
GrowSurf signs webhook deliveries when the webhook has a secret configured: each delivery includes a GrowSurf-Signature HMAC header computed with that secret (the secret is write-only and never returned). To securely use webhooks, we recommend the following:
secret on the webhook and verify the GrowSurf-Signature header on receiptThe GrowSurf MCP server provides a helper tool (growsurf_webhook_normalize) that normalizes webhook payloads and generates a best-effort idempotency key to simplify safe webhook processing.
npm run dev
npm testRead developer docs at the following:
The GrowSurf MCP server helps GrowSurf customers implement referral programs and affiliate programs quickly.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add growsurf --transport http https://mcp.growsurf.com{
"mcpServers": {
"growsurf": {
"url": "https://mcp.growsurf.com",
"type": "http"
}
}
}code --add-mcp '{"name":"growsurf","url":"https://mcp.growsurf.com","type":"http"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/growsurf-mcp-server to learn what the "GrowSurf MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx -y @growsurfteam/growsurf-mcp --compact
npx -y @growsurfteam/growsurf-mcp
npx -y @growsurfteam/growsurf-mcp --help
npx -y @growsurfteam/growsurf-mcp --versionclaude mcp add --transport http --scope user growsurf https://mcp.growsurf.com
claude mcp add growsurf| Name | What it does |
|---|---|
growsurf_integration_guide | Generate a guided, happy-path GrowSurf integration plan (referral + affiliate). |
growsurf_agent_program_creation_eval | Generate one-shot GrowSurf program-creation eval prompts and acceptance checks for agent steering: starter content review, conservative rewards, configuration review, and frontend install proof. |
growsurf_program_design_advisor | Generate program designs, benchmarks, typical rewards, and metric definitions, including participant-to-referral and lead-to-referral ratios. Read-only. Returns a short draft, complete `benchmarkFacts |
growsurf_troubleshoot_referral_tracking | Diagnose referral tracking and program problems. Accepts a symptom or description without requiring a program or participant ID. Covers referrals not credited, participant emails not sending, rewards |
growsurf_mobile_sdk_guide | Generate native iOS/Android SDK 0.6.0 guidance, including attribution, shareUrl sharing, trackShare, and the native GrowSurf Window. |
growsurf_api_library_snippets | Generate official REST API library snippets for TypeScript, Python, PHP, Ruby, and Java, including Create Mobile Participant Token. |
growsurf_get_campaign | Fetch your GrowSurf campaign (program) details via REST. Embedded reward settings do not establish that an individual reward was earned, approved, or delivered. Earned reward records belong to the ind |
growsurf_list_campaigns | List the GrowSurf programs available to the bound team, including their IDs for program selection. Deleted programs are not returned. Does not require `GROWSURF_CAMPAIGN_ID`. |
growsurf_create_campaign | Create a new GrowSurf program (campaign) with type-appropriate starter content and optional inline rewards. Starter content includes Design, Emails, Options, Installation, and GrowSurf Window defaults |
growsurf_update_campaign | Update your GrowSurf program's (campaign's) identity and lifecycle: name, companyName, companyLogoImageUrl, and status (set IN_PROGRESS to publish/resume the program, COMPLETE to end it). Only the fie |
growsurf_clone_campaign | Clone your GrowSurf program (campaign) into a new DRAFT program. Integrations and credentials are not copied; active rewards are cloned. Targets `campaignId` if you pass it, otherwise GROWSURF_CAMPAIG |
growsurf_list_campaign_rewards | List your GrowSurf program's configured Campaign Rewards, including switched-off rewards and rewards whose group is not selected. Deleted rewards are excluded. A reward can be earned only when it also |
growsurf_create_campaign_reward | Create a new campaign reward (reward config) on your GrowSurf program. `type` must be compatible with the program type (affiliate programs support only AFFILIATE rewards; referral programs support the |
growsurf_update_campaign_reward | Update an existing campaign reward (reward config) on your GrowSurf program. `campaignRewardId` is the reward key (e.g. crew_...). The reward `type` is immutable. Targets `campaignId` if you pass it, |
growsurf_delete_campaign_reward | Delete a campaign reward (reward config) from your GrowSurf program. The reward is deactivated, removed from the program's reward set, and any connected upfront-discount coupons are cleaned up. `campa |
growsurf_list_program_resources | List the participant resources configured for your GrowSurf program, including drafts. Results stay in display order. Targets `campaignId` if you pass it, otherwise GROWSURF_CAMPAIGN_ID. |
growsurf_prepare_program_resource_file | Prepare a local file for a `FILE` Program Resource. Accepts a safe file name, matching supported MIME type, and padded base64 bytes, up to 10 MB. GrowSurf requests a one-time ticket and uploads only t |
growsurf_create_program_resource | Create a `FILE`, `LINK`, or `TEXT` resource for participants. `LINK` requires an HTTPS `url`. `TEXT` requires plain `text`. A `FILE` up to 10 MB requires a one-time `uploadTicket` and the unmodified ` |
growsurf_update_program_resource | Update at least one participant resource field, or move it to a zero-based `position`. Only supplied fields change. A replacement `FILE` requires a one-time `uploadTicket` and the unmodified `uploadRe |
growsurf_delete_program_resource | Delete a participant resource from your GrowSurf program. This does not remove its reusable Media Center asset. Targets `campaignId` if you pass it, otherwise GROWSURF_CAMPAIGN_ID. |
growsurf_get_campaign_design | Fetch the configured design fields for your GrowSurf program, including GrowSurf Window content, colors, sharing sections, participant avatars under `participantAvatarStyle`, referred-visitor content |
growsurf_update_campaign_design | Update the design configuration for your GrowSurf program, including participant avatars under `participantAvatarStyle`, referred-visitor content such as the Claim Offer Popup, the website widget unde |
growsurf_get_campaign_emails | Fetch the Emails tab configuration for your GrowSurf program, including participant and admin email templates, settings, and read-only fields. `settings.sender.fromEmail` is read-only and can be chang |
growsurf_update_campaign_emails | Update writable Emails tab fields for your GrowSurf program under `fields`, in their existing nested shape. `settings.sender.fromEmail` is read-only; sender address changes require domain verification |
growsurf_get_campaign_options | Fetch the Options tab configuration for your GrowSurf program (referral triggers, anti-fraud lists and toggles, affiliate enrollment and application review, notifications, and other behavior options). |
growsurf_update_campaign_options | Update the Options tab configuration for your GrowSurf program under `fields`, in its existing nested shape. Only supplied fields change; omitted fields retain their existing values and arrays replace |
growsurf_get_campaign_installation | Fetch the Installation tab configuration for your GrowSurf program (embed/installation and tracking setup). Returns the full object with every field and its current value — the same shape you send bac |
growsurf_update_campaign_installation | Update the Installation tab configuration for your GrowSurf program under `fields`. Only supplied fields change; omitted fields retain their existing values and arrays replace wholesale. `allowedUrls` |
growsurf_capture_referral_flow_screenshots | Capture temporary GrowSurf preview screenshots after a draft program is saved. Returns short-lived URLs for the controlled referrer Window and referred-friend experience, with an `expiresAt` timestamp |
growsurf_create_account | Create a brand-new GrowSurf account and return an API key. Requires the authorized owner's explicit approval of account creation and acceptance of GrowSurf's Terms of Service (https://growsurf.com/ter |
growsurf_get_team | Fetch the team bound to the API key or OAuth connection. `verificationStatus` is `VERIFIED` once GrowSurf has verified the team, which is required before a program can email participants. Personal pro |
growsurf_update_team | Update the display name of the team bound to the API key or OAuth connection. Personal profiles, billing, and team ownership are not editable here. Requires `GROWSURF_API_KEY`; does not require `GROWS |
growsurf_request_team_verification | Ask GrowSurf to verify the team bound to the API key or OAuth connection. Verification is required before a program can email participants. Calling this again while a request is pending does not creat |
growsurf_resend_team_owner_verification_email | Resend the email-verification message to the bound team's owner. The response never reveals the owner's email address. A `200` with `status: SENT` is returned only when an email was sent. Returns `400 |
growsurf_get_campaign_analytics | Fetch analytics for your GrowSurf program: participants, referrals, impressions, per-channel shares, and affiliate revenue, commission, and payout metrics when applicable. Pass `interval` (`day`, `wee |
growsurf_get_campaign_activation_analytics | Fetch strict activation for eligible participants in one enrollment cohort. Referral programs group by `enrolledAsAdvocateAt`; affiliate programs group by `approvedAsAffiliateAt`. The ordered stages a |
growsurf_list_integrations | List the integrations available to your GrowSurf program, including Stripe, PayPal, Wise, Mailchimp, Slack, Zapier, and Webhooks. Each entry includes `connected` (credentials stored), `enabled` (worki |
growsurf_list_campaign_webhooks | List your GrowSurf program's webhooks (secrets are never returned). Targets `campaignId` if you pass it, otherwise GROWSURF_CAMPAIGN_ID. |
growsurf_create_campaign_webhook | Add a webhook to your GrowSurf program. `payloadUrl` is required. `events` is the list of events this webhook is subscribed to (omit to subscribe it to no events). `secret` is write-only — GrowSurf us |
growsurf_update_campaign_webhook | Update a webhook on your GrowSurf program by id (`webhookId` is `primary` for the program's primary webhook). Only the fields you send are changed. `secret` is write-only and never returned. Targets ` |
growsurf_delete_campaign_webhook | Remove a webhook from your GrowSurf program by id. Returns { id, success }. Targets `campaignId` if you pass it, otherwise GROWSURF_CAMPAIGN_ID. |
growsurf_test_campaign_webhook | Send a live test event to a webhook on your GrowSurf program using its stored URL and secret. Optionally pass `event` to choose which event type to simulate; when omitted, the webhook's first enabled |
growsurf_list_participants | List participants in your GrowSurf program, newest page first. `limit` is 1-100 (default 10). Pass response `nextId` into the next call to continue paging. Pass `metadata` to return only participants |
growsurf_get_participant | Fetch a single participant by GrowSurf participant ID or email address. `referralStatus` describes credit to their referrer; `referralCount` counts referrals this participant generated, so zero is con |
growsurf_add_participant | Add or fetch a participant by email. Existing participants are returned unchanged. This is trusted direct enrollment and bypasses the public application review flow for affiliates. For affiliate progr |
growsurf_update_participant | Update a participant by GrowSurf participant ID or email. Only the fields you send are changed; read-only fields such as counters, `isAffiliate`, `origin`, and fraud state are rejected with a `400`. I |
growsurf_bulk_delete_participants | Bulk delete participants from your GrowSurf program in one request. DESTRUCTIVE: deletion is permanent, cannot be undone, and removes the participants' referrals, rewards, commissions, and payout reco |
growsurf_email_participant | Send an email to a participant (by GrowSurf participant ID or email). Provide EITHER `emailType` to trigger one of the program's configured email templates, OR `subject` + `body` for a free-form email |
growsurf_get_participant_analytics | Fetch analytics for one participant by GrowSurf participant ID or email. The base response includes all-time engagement, rank, share, and applicable affiliate revenue, commission, and payout metrics. |
growsurf_get_participant_activity_logs | List a participant's activity logs (by GrowSurf participant ID or email), most recent first, offset/limit paginated. `limit` is 1-100 (default 20); `offset` skips logs. The response `offset` is the cu |
| Name | What it does |
|---|---|
create_referral_program | Create and configure a GrowSurf referral program from the proven referral template. |
create_affiliate_program | Create and configure a GrowSurf affiliate program from the proven affiliate template. |
embed_referral_widget | Produce the installation plan and snippets for adding GrowSurf to a web app. |
list_campaigns | List GrowSurf programs so you can choose the right campaign id. |
get_campaign | Fetch one GrowSurf program by campaign id. |
list_participants | List participants in a GrowSurf program. |
get_participant | Fetch one GrowSurf participant by id or email. |
set_rewards | Safely review and adjust GrowSurf reward configs. |
wire_webhooks | Plan and configure GrowSurf webhooks for product automation. |
read_analytics | Analyze GrowSurf campaign or participant performance. |
advise_program_design | Recommend a referral or affiliate program design for a business before creating or changing rewards. |
troubleshoot_referral_tracking | Diagnose why referrals, participants, rewards, or emails are not behaving as expected. |
| Name | What it does |
|---|---|
GrowSurf Agent and Developer Index | First-party links for understanding, integrating, and automating GrowSurf. |
Read live from the server on October 5, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/growsurf-mcp-server)Nothing comparable is listed yet.
v0.19.33Release notesv0.19.32Release notesv0.19.31Release notesv0.19.30Release notesv0.19.29Release notesv0.19.28Release notesv0.19.27Release notesv0.19.26Release notesv0.19.25Release notesv0.19.24Release notesv0.19.23Release notesv0.19.22Release notesv0.19.21Release notesv0.19.20Release notesv0.19.19Release notesv0.19.18Release notesv0.19.17Release notesv0.19.16Release notesv0.19.15Release notesv0.19.14Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "growsurf-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.