Skip to main content
Glama
GrowSurf MCP Server

GrowSurf MCP Server

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GROWSURF_API_KEYNoOptional for startup; required for API-calling tools. Use a key with the scopes and program access those tools need.
GROWSURF_CAMPAIGN_IDNoOptional; 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_URLNoOptional; defaults to https://api.growsurf.com/v2. Useful for local or hosted MCP gateways that should call a different GrowSurf API origin.https://api.growsurf.com/v2
GROWSURF_WEBHOOK_TOKENNoOptional; used for your own webhook URL token scheme.
GROWSURF_UPLOAD_ALLOWED_ORIGINSNoRequired 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.
GROWSURF_PARTICIPANT_AUTH_SECRETNoOptional; used by the hash helper.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

GrowSurf runs a customer's live referral or affiliate program. The settings you write are what their participants see, and the reward amounts you write are what the customer pays out.

To design, recommend, or draft a referral or affiliate program, first call growsurf_program_design_advisor with the available context. Drafting is read-only; give the first draft before asking creation questions. Present its configurationPlan as tool calls, preserving each tool and arguments object. Use decisions.qualifyingAction consistently in the offer, rules, and tracking plan. Leave decisions.unresolved choices undecided. For any benchmark or metric-definition question, call the advisor. Quote its benchmarkFacts as complete statements. Request detail: full for additional cuts. Copy each metric label, median, Q1, Q3, sample, and source together. Do not rename a ratio, change its denominator, or turn quartiles into a full range. If space is limited, omit figures instead of shortening away their meaning. Do not add outside figures.

Before executing a program creation, resolve these with the person, asking at most two short questions and skipping anything they already told you:

  • What the program is for, so share settings match the audience. Use the creation goal from configurationPlan; the advisor's goal uses a different enum.

  • The incentive, and who funds and fulfills it.

Never choose a reward or commission amount yourself, including sample offers and copy. A budget is a spending limit, not a confirmed incentive. If the person has not named an incentive, omit rewards from growsurf_create_campaign. The program is then created with GrowSurf's starter rewards switched off, so it awards nothing until they decide the amount and turn one on. Say that, rather than reporting an amount you picked.

Read a configuration tab before you patch it, and change only what the request calls for. Treat an existing value the customer already set, such as the program's Share URL, as theirs: to make GrowSurf work on another origin, add that origin to allowedUrls instead of replacing the Share URL, and ask before changing one that is already set.

Call growsurf_program_design_advisor before proposing rewards or a qualifying action, and for any question about what other GrowSurf programs do: typical or median reward amounts, how common a reward type or qualifying action is, or any benchmark figure. It is the only source of those figures. Every input is optional, so call it with what the person already said instead of asking for a company name or budget first.

When anything about a program misbehaves (referrals not credited, emails not sending, rewards not issued, participants missing, the Universal Code not detected, an integration or CRM not syncing, a Zapier error, fraud flags, analytics numbers that look wrong), call growsurf_troubleshoot_referral_tracking first and run its checks before concluding.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}
prompts
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
growsurf_integration_guideA

Plan a web integration for a referral or affiliate program. Returns Markdown steps for installing the Universal Code, identifying participants, tracking referrals or sales, and verifying webhooks. Does not inspect or change a program. Use growsurf_client_snippets for browser JavaScript examples, growsurf_api_library_snippets for backend code, or growsurf_mobile_sdk_guide for native or React Native apps.

growsurf_agent_program_creation_evalA

Generate Markdown prompts and acceptance checks for evaluating an agent's program-creation workflow: starter content, rewards, configuration, and frontend installation. Does not create a program or run the checks. Use growsurf_program_design_advisor to choose a program design, or growsurf_integration_guide to plan its web integration.

growsurf_program_design_advisorA

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, a proposed configurationPlan, and unresolved decisions. Incentive amounts and qualifying actions remain unresolved unless supplied by the customer. detail: summary returns a configuration draft and reward structure; detail: full adds detailed benchmark tables. Hosted figures describe GrowSurf's high-performing programs; without a bundle, guidance is documentation-based. programType: AFFILIATE selects affiliate advice. industry: other covers local services, pets, hospitality, and agencies. All inputs are optional.

growsurf_troubleshoot_referral_trackingA

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 not issued, participants not added, Universal Code not detected, integrations or CRMs not syncing, Zapier errors, fraud flags, and analytics discrepancies. Returns ordered diagnostic checks, likely causes, fixes, and documentation links. It does not read program or participant records. Unknown symptom keys return the available symptoms. A description matches only when it contains a symptom label or alias verbatim; otherwise the symptom list is returned.

growsurf_mobile_sdk_guideA

Get Markdown implementation guidance for native iOS/Android SDK 0.10.6 or React Native SDK 0.3.4, including attribution, shareUrl sharing, trackShare, and the native GrowSurf Window. Choose platform and participantState to tailor the guide; includeInstallSnippets controls installation examples. Does not install an SDK or create a participant token. Use growsurf_client_snippets for browser JavaScript or growsurf_api_library_snippets for backend token-creation code.

growsurf_api_library_snippetsA

Generate Markdown code examples for the official backend REST API libraries in TypeScript, Python, PHP, Ruby, and Java. Select language and workflow; both default to all. Covers setup, program lookup, participant creation, referral credit, sales, and mobile participant tokens. Returns code without executing API calls. Use growsurf_client_snippets for browser JavaScript or growsurf_mobile_sdk_guide for native or React Native app setup.

growsurf_get_campaignA

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 individual participant. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_list_campaignsA

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_campaignA

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. Only type is required. The program starts in DRAFT status and is owned by the credential's bound team. currencyISO defaults to USD and is immutable after creation. goal sets the sharing settings at creation and cannot be set later. Incentives require the customer's chosen amount or commission rate. Without rewards, GrowSurf's starter rewards are switched off and award nothing. Editor-tab configuration is not accepted here. Does not require GROWSURF_CAMPAIGN_ID. The response includes the new program id.

growsurf_update_campaignA

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 fields you send are changed. type, urlId, and currencyISO are immutable (currency is chosen once at program creation), so this tool does not accept them. Editor-tab config (design, emails, options, installation) is edited with the dedicated config sub-resource tools, not here. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_clone_campaignA

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_CAMPAIGN_ID.

growsurf_list_campaign_rewardsA

List your GrowSurf program's configured Campaign Rewards, including switched-off rewards and rewards whose reward type is not selected. Deleted rewards are excluded. A reward can be earned only when it also appears in the campaign response's embedded rewards array. The list includes every group's rewards; each reward's groupId names its group (null is Default). These settings do not establish that a participant earned or received a reward; earned reward records belong to the individual participant. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_create_campaign_rewardA

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 other types). An AFFILIATE reward also requires commissionStructure. A concurrent edit can return 409; reload the program before retrying. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_update_campaign_rewardA

Update an existing campaign reward (reward config) on your GrowSurf program. campaignRewardId is the reward key (e.g. crew_...). The reward type is immutable. A concurrent edit can return 409; reload the program before retrying. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_delete_campaign_rewardA

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. campaignRewardId is the reward key. Returns { id, success }. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_list_campaign_groupsA

List your GrowSurf program's groups in display order. Groups give some participants a different reward list. Each participant is in one group, and groupId: null is Default, which holds the program's standard rewards and is not in this list. A group's rewards replace Default's whole reward list for its members' new referrals. Leaderboard rewards stay program-wide. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_create_campaign_groupA

Create an empty group on your GrowSurf program. Add Campaign Rewards with this group's groupId before adding participants or rules. Omit rules or send an empty array; nonempty rules return 400. Use growsurf_update_campaign_group to add rules after configuring rewards. Group names must be unique, ignoring case; Default is reserved. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_update_campaign_groupA

Rename, reorder, or change the rules of a group on your GrowSurf program. Sending rules replaces the whole list. An added PARTICIPANT rule moves that participant in now; a removed one moves them back to Default if they are still in this group. Email and domain rule changes move no one. To change the group's rewards, use growsurf_update_campaign_reward. Group names must be unique in the program (case is ignored), and "Default" is reserved. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_delete_campaign_groupA

Delete a group from your GrowSurf program. Its members move to Default, and its Campaign Rewards are removed from the program. Rewards already earned keep their amounts and can still be sent. Returns { id, success, movedToDefault }. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_list_program_resourcesA

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_fileA

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 to the secure HTTPS destination selected by GrowSurf. Returns the original uploadTicket and uploadResult required for file resource creation or replacement. Altered upload results are not valid. The tool does not accept upload URLs or credentials and never retries an ambiguous upload. Requires GROWSURF_UPLOAD_ALLOWED_ORIGINS on the server; without it, only LINK and TEXT resources are available. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_create_program_resourceA

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 uploadResult from GrowSurf's secure upload flow. New resources default to draft unless isPublished is set. API reference: https://growsurf.com/openapi.json. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_update_program_resourceA

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 uploadResult from GrowSurf's secure upload flow. API reference: https://growsurf.com/openapi.json. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_delete_program_resourceA

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_designB

Fetch the configured design fields for your GrowSurf program, including GrowSurf Window content, colors, sharing sections, participant avatars under participantAvatarStyle, referred-visitor content such as the Claim Offer Popup, the website widget under widget, the participant Traffic report under trafficInsights (it starts on for new affiliate programs and hidden for referral programs, and every setting is returned with its default copy), participant sign-in copy under login, payout-destination confirmation page copy under payoutDestinationConfirmation, country-name overrides under countryLabels, and the participant Settings panel under participantSettings (its languageSectionTitle and languageSectionInstructionsText label the language picker shown when the program has more than one language). participantAvatarStyle is CHARACTERS, INITIALS, ANIMALS, or GRADIENT; missing or unknown values mean INITIALS. visualStyle is the program Style (GLOW, CLEAN, FLAT, ROUND, TINT, or GLASS) and is omitted when the program has no saved Style. The confirmation section is omitted when no confirmation fields are stored. Stored null fields are returned as null; omitted and null fields use localized defaults. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_update_campaign_designA

Update the design configuration for your GrowSurf program, including participant avatars under participantAvatarStyle, referred-visitor content such as the Claim Offer Popup and the side content of its GrowSurf page (referredExperience.offerPageDescription HTML, up to 5 offerPageSteps of { text, iconKey }, and up to 3 offerPageLinks of { text, url } where an empty url links to the Share URL), the website widget under widget (button or card, placement, timing, and visible pages), the participant Traffic report under trafficInsights, participant sign-in copy under login, payout-destination confirmation page copy under payoutDestinationConfirmation, and the participant Settings panel under participantSettings, such as the language picker's languageSectionTitle (up to 100 characters) and languageSectionInstructionsText (up to 255 characters). trafficInsights.isPublicDisplayed controls visibility; its labels cannot be blank. participantAvatarStyle accepts CHARACTERS, INITIALS, ANIMALS, or GRADIENT. visualStyle accepts GLOW, CLEAN, FLAT, ROUND, TINT, or GLASS; it sets corners, shadows, button shape and background on program pages and the GrowSurf Window. Changing it also fills theme.buttons.borderRadius and the theme.globalBoxShadow fields unless the same request sets them. Text fields use the same character limits as the dashboard Program Editor. Text the Program Editor requires, such as Window labels, button text, and status names, cannot be set to null, empty, or only spaces. Only supplied fields change; omitted fields retain their existing content and arrays replace wholesale. One call can change many fields, so send related changes together instead of one field per call. Read growsurf_get_campaign_design first and use its field names and allowed values exactly. An invalid field returns an error that names the field. After a design change is saved, call growsurf_capture_referral_flow_screenshots for short-lived preview screenshots of the referrer and referred-friend experiences. They show the saved program, not the customer's site. Image, icon, and link fields must be hosted http(s) URLs, not data: URIs. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_campaign_emailsA

Fetch the Emails tab configuration for your GrowSurf program, including participant email templates, settings, and read-only fields. settings.sender.fromEmail is read-only and can be changed in the dashboard after domain verification. When updating, omit unchanged sender fields; fromName and replyToEmail cannot be cleared with null. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_update_campaign_emailsA

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 in the dashboard. settings.sender.fromName and settings.sender.replyToEmail accept non-empty strings, not null. Omit either field to keep its current value, including an unset value returned by a read. The invite and transactional email isEnabled toggles are read-only. An email subject cannot be empty. Email bodies require their template links and footer tokens. When settings.design.layoutMode is INLINE, each body must include {{emailFooter}}; {{emailHeader}} is optional. layoutMode is read-only. Omitted fields retain their existing content; arrays replace wholesale. One call can change many fields, so send related changes together instead of one field per call. Read growsurf_get_campaign_emails first and use its field names and allowed values exactly. An invalid field returns an error that names the field. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_campaign_optionsA

Fetch the Options tab configuration for your GrowSurf program (referral triggers, anti-fraud lists and toggles, affiliate enrollment and application review, notifications, the program's languages under languages, and other behavior options). languages.baseLanguageTranslation is read-only: it counts Program Editor text that is not in a non-English base language yet, which the customer can translate from Options > Languages in the dashboard. Returns the full object with every field and its current value, the same shape you send back on update. autoFulfillRewards: false permits manual fulfillment and does not prove that any reward went undelivered. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_update_campaign_optionsA

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 wholesale. languages.additionalLanguages takes the full list of extra languages; send [] to turn them off. The base language is dropped from that list and duplicates collapse. languages.showFlags shows or hides the flag next to each language name. languages.flagCountries picks the flag for a language that offers more than one, such as { "en": "GB" }; null restores the default flag. Turning on languages.additionalLanguages returns 403 if your account does not include additional languages. While any are on, every languages change, including turning them off, returns the same 403. Translations are managed in the GrowSurf dashboard, not through this tool. The response's read-only languages.baseLanguageTranslation counts Program Editor text that is not in a non-English base language yet (untranslated of total; null for en, or when the account does not include additional languages). When untranslated is above 0 a few minutes after a baseLanguage change, tell the customer they can translate that text from Options > Languages in the dashboard. The field is ignored if you send it back. Do not rewrite the text yourself. notificationEmails.recipients needs at least one valid email address. One call can change many fields, so send related changes together instead of one field per call. Read growsurf_get_campaign_options first and use its field names and allowed values exactly. An invalid field returns an error that names the field. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_campaign_installationA

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 back on update. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_update_campaign_installationA

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 includes permitted browser origins such as http://localhost:3000. An origin missing from both shareUrl and allowedUrls can return 403. Referral links already shared point at the current shareUrl. Replacing an existing Share URL requires the customer's explicit approval and replaceExistingShareUrl: true; otherwise the patch is refused. One call can change many fields, so send related changes together instead of one field per call. Read growsurf_get_campaign_installation first and use its field names and allowed values exactly. An invalid field returns an error that names the field. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_campaign_custom_domainA

Fetch the custom domain that serves your GrowSurf program's landing pages, such as https://refer.example.com. Returns domain (null when none is set), isVerified, verifiedAt, and dnsRecord, the CNAME record to add at the DNS provider. This read does not check DNS; use growsurf_verify_campaign_custom_domain for a live check. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_set_campaign_custom_domainA

Set or replace the custom domain for your GrowSurf program's landing pages. Pass a hostname such as refer.example.com in domain; https:// is added if you leave it out. Paths, ports, queries, and http:// return 400. Replacing a domain removes the old one right away, and its pages stop loading there, so confirm with the customer before replacing a domain that is already set. Sending the current domain again changes nothing. A domain used by another program returns 409, and 403 means the account cannot use custom domains yet: a higher plan is needed, or for an affiliate program, a payment method on file. A new domain starts unverified: add the CNAME record from the returned dnsRecord at the DNS provider (dnsRecord.name pointing to dnsRecord.value), then call growsurf_verify_campaign_custom_domain. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_verify_campaign_custom_domainA

Check the program's custom domain DNS now and return the result in isVerified. Call it after the CNAME record from dnsRecord is in place. If the record is wrong or has not propagated yet, isVerified stays false; try again later. The first time the check passes, GrowSurf sets up the domain's SSL certificate, and pages can take a few minutes to load over https:// after that. More than one CNAME record on the hostname returns 400. Returns 404 when no custom domain is set. A domain that is already verified is returned as is, without a new check. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_remove_campaign_custom_domainA

Remove the custom domain from your GrowSurf program. Its landing pages stop loading on that domain and go back to their GrowSurf URL. Returns { domain, success }. Returns 404 when no custom domain is set. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_capture_referral_flow_screenshotsA

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 in UTC. The screenshots reflect the saved program at capture time and do not verify installation on the customer's site. A failed inline image alone does not establish that the URL expired. This tool does not accept arbitrary URLs, HTML, JavaScript, or external screenshot targets. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_teamA

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 profiles and internal identifiers are not returned. Requires GROWSURF_API_KEY; does not require GROWSURF_CAMPAIGN_ID.

growsurf_update_teamA

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 GROWSURF_CAMPAIGN_ID.

growsurf_request_team_verificationA

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 create a duplicate. Returns the team with its updated verificationStatus. Requires GROWSURF_API_KEY; does not require GROWSURF_CAMPAIGN_ID.

growsurf_resend_team_owner_verification_emailA

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 if the email is already verified and 429 if one was sent too recently. Requires GROWSURF_API_KEY; does not require GROWSURF_CAMPAIGN_ID.

growsurf_get_campaign_analyticsA

Fetch analytics for your GrowSurf program: participants, referrals, impressions, per-channel shares, and affiliate revenue, commission, and payout metrics when applicable. Pass interval (day, week, or month) for a per-period series. Pass comma-separated include values for previousPeriod, statusCounts, rates, email, or engagement. engagement groups unique active, sharing, repeat, and retained participants by when portal views and share actions occurred. Its coverageStartAt, state, and reason distinguish measured zeroes from partial or unavailable history. Scope the timeframe with days (default 365, max 1825) or an explicit startDate/endDate window. Explicit dates must both be positive Unix timestamps in milliseconds, with endDate >= startDate and a maximum span of 1825 days. timezone and platform apply to engagement only. Targets campaignId if passed, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_campaign_activation_analyticsA

Fetch strict activation for eligible participants in one enrollment cohort. Referral programs group by enrolledAsAdvocateAt; affiliate programs group by approvedAsAffiliateAt. The ordered stages are ELIGIBLE, PORTAL_VIEWED, SHARE_ACTION, UNIQUE_REFERRAL_VISIT, LEAD, and CREDITED_REFERRAL. Each participant gets the selected 7- or 30-day observation window. Omit both cohort bounds for the latest fully matured cohort. Read coverageStartAt, state, and reason before interpreting a null or zero; unavailable history does not mean an action never happened. Targets campaignId if passed, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_list_integrationsA

List the integrations available to your GrowSurf program, including Stripe, PayPal, Wise, Mailchimp, Slack, Zapier, and Webhooks. Each entry includes connected (credentials stored), enabled (working), autoDisabled (delivery stopped after repeated failures until the user reconnects), and connectUrl (dashboard connection link). Integrations that do not apply to the program type are omitted, such as Wise on a referral program. Read-only. Account connection takes place in the GrowSurf dashboard and is not available through the API. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_list_campaign_webhooksA

List your GrowSurf program's webhooks (secrets are never returned). Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_create_campaign_webhookA

Add a webhook to your GrowSurf program. payloadUrl is required. events is the list of events this webhook is subscribed to. Omit it to subscribe the webhook to every event its program type offers, or send [] for none. An event the program type does not offer returns 400. A program can have up to 5 webhooks, counting the primary webhook, so you can create up to 4. Creating another returns 400. secret is write-only — GrowSurf uses it to sign deliveries (the GrowSurf-Signature HMAC header) and never returns it. A program can have only one saved Bask Health webhook across all bask.ninja hosts and paths, including disabled webhooks. A second Bask Health webhook returns 400. A concurrent change to webhook settings can return 409; reload the webhooks before retrying. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_update_campaign_webhookA

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. A program can have only one saved Bask Health webhook across all bask.ninja hosts and paths, including disabled webhooks. An update that leaves more than one Bask Health webhook returns 400. A concurrent change to webhook settings can return 409; reload the webhooks before retrying. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_delete_campaign_webhookA

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_webhookA

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 event is used (returns 400 if the webhook has no enabled events). Returns the mock payload and the receiving endpoint's response. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_list_participantsA

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 whose stored metadata matches every given key and value exactly, for example { "customerId": "12345" } to look someone up by your own customer ID; filtered results are ordered by participant ID. Results include participant IDs. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_participantA

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 consistent with CREDIT_AWARDED. In rewards, approved records approval; status, isFulfilled, and fulfilledAt record fulfillment marking, not confirmation of delivery. When no participant matches, the tool returns an error result, not an empty result. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_add_participantA

Add or fetch a participant by email. If the email already exists, the existing participant is returned unchanged. One exception: if that participant claimed an offer in the Claim Offer Popup and the signup is not complete yet, this call completes the signup with the original referrer and saves any non-blank firstName, lastName, and metadata you send. This is trusted direct enrollment and bypasses the public application review flow for affiliates. For affiliate programs, set isAffiliate to true to enroll a new participant as approved or false to create a non-affiliate. If you omit it, a valid referredBy creates a referred non-affiliate; without a valid referrer, the new participant is enrolled as approved. A valid referredBy can be combined with isAffiliate: true. A 409 means the same participant is already being added or cannot join right now, so do not retry in a loop. A 422 means the program's fraud rules blocked the participant. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_update_participantA

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. In affiliate programs, affiliateStatus accepts APPROVED, SUSPENDED, or BANNED; APPROVED enrolls the participant, while SUSPENDED and BANNED require an existing affiliate. Affiliate enrollment cannot be removed through REST. notes is freeform internal notes (never shown to participants). Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_bulk_delete_participantsA

Bulk delete participants from your GrowSurf program in one request. DESTRUCTIVE: deletion is permanent and cannot be undone. Successful rows lose participant access immediately; related record cleanup completes automatically, subject to required financial record retention. Each entry in participants is a GrowSurf participant ID or an email address (mixed lists are allowed), up to 200 entries per request — chunk larger lists across multiple calls. Returns a summary (total, deletedCount, notFoundCount, duplicateCount, errorCount) plus per-row results in request order, each with status DELETED, NOT_FOUND, DUPLICATE (resolves to the same participant as an earlier entry), or ERROR — both 200 and 202 responses can include NOT_FOUND or ERROR rows, and the summary reports these outcomes. A 202 response includes analyticsErasure when analytics erasure is pending. DELETED means participant access was removed; reports can retain the participant until cleanup completes. Do not repeat successful rows to finish cleanup. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_bulk_move_participantsA

Move participants in your GrowSurf program to a group, or to Default with groupId: null. Each entry in participants is a GrowSurf participant ID or an email address (mixed lists are allowed), up to 200 entries per request. All found participants move together: if the move fails, no one moves. A move is a manual placement, so the groups' email and domain rules do not override it later. A move applies to new referrals only; rewards already earned keep their amounts. Returns a summary (total, groupId, movedCount, notFoundCount, duplicateCount, errorCount) plus per-row results in request order, each with status MOVED, NOT_FOUND, DUPLICATE, or ERROR. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_email_participantA

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 (optionally preheader). For programs with settings.design.layoutMode set to INLINE, body must include {{emailFooter}}; {{emailHeader}} is optional. Free-form emails are sent with the same compliance handling (company name, postal address, and an unsubscribe link are added automatically, and unsubscribed participants are suppressed). Sending requires the team to be verified by GrowSurf and a verified custom email domain on the program (set up in Program Editor > 3. Emails > Email Settings). Returns 400 until one is verified. The email is accepted for delivery. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_participant_analyticsA

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. Add activation to include for the program-specific eligibility anchor and covered first milestones, including firstPortalViewedAt and firstShareChannel. A null milestone with a partial or unavailable state is unknown, not proof that the action never happened. Request both activation and series for covered portalViews and shareActions buckets. Filter optional series and email data with days (up to 1825) or both startDate and endDate as positive Unix timestamps in milliseconds. endDate must be at or after startDate, and the range can span at most 1825 days. These date parameters do not filter the base response or activation milestones. Targets campaignId if passed, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_participant_activity_logsA

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 cursor for the next page (null when there are no more). Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_trigger_referralA

Trigger referral credit for a referred participant (use when your trigger is Sign up + Qualifying Action). Optionally pass delayInDays (1-90) to hold the credit for N days before awarding it (e.g. to cover a refund window). Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_cancel_delayed_referralA

Cancel a pending delayed referral trigger for a participant before the delay elapses (e.g. on refund/cancellation). Returns { success, message }; success is false when the participant has no pending delayed trigger. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_get_participant_payout_destinationA

Get a participant's payout-destination status (by GrowSurf participant ID or email) across every payout provider enabled for the program (PayPal, Venmo, or Wise). For each provider it reports the current status, the confirmed payout email, the legal recipient type, and — when a delivery bounced or a recipient was invalidated — the repair reason. activeProvider is the provider that currently gets paid, or null until the participant confirms one. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_request_participant_payout_destination_confirmationA

Ask a participant to confirm their payout destination for a provider (by GrowSurf participant ID or email). Sends them a one-time confirmation link for the chosen provider; only the participant can open the link and confirm — this just triggers the message, and the provider must be enabled for the program. Returns { status, provider, providerDisplayName, expiresAt }. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_record_saleA

Record a sale/transaction for an affiliate program. Use webhooks to know when commissions are added. Requires at least one transaction identifier (externalId, transactionId, orderId, paymentId, invoiceId, paymentIntentId, or chargeId) so repeated calls are de-duplicated instead of double-paying the referrer; reuse the same one when refunding. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_refund_transactionA

Record a refund, partial refund, or chargeback for a previously recorded affiliate transaction in GrowSurf and reverse or adjust the referrer's commission. This records the amendment without sending a refund through the payment provider. Requires the same transaction identifier as the original sale. Omitted amountRefunded means a full refund. Already-paid commissions are not clawed back and are recorded for tax only. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_create_mobile_participant_tokenA

Create or fetch a participant, then create a participant-scoped mobile SDK token via GrowSurf REST. Participant creation is trusted direct enrollment and bypasses the public application review flow for affiliates. The program must have mobile SDK access enabled. isNew is false when the participant already existed; a repeat call can return true while the first signup is still finishing. Targets campaignId if you pass it, otherwise GROWSURF_CAMPAIGN_ID.

growsurf_participant_auth_hashA

Compute a SHA-256 HMAC using the caller-supplied participantAuthSecret. Server environment secrets are never used. Use a test secret during implementation; keep production signing in your backend. affiliateJoin requires permission for this signed-in user to join the affiliate program directly.

growsurf_webhook_normalizeA

Validate/normalize a GrowSurf webhook payload and generate a best-effort idempotency key for dedupe.

growsurf_client_snippetsA

Generate Markdown browser JavaScript and CSS examples for referral tracking, embeddable elements, and the GrowSurf Window, with placement guidance. Does not install code or change a program. Use growsurf_embeddable_element_snippet for one HTML element, growsurf_grsf_config_snippet for window.grsfConfig, or growsurf_api_library_snippets for backend REST code.

growsurf_embeddable_element_snippetA

Generate one embeddable element's HTML as Markdown. Choose element; optionally include participant authentication attributes. Does not install the element or change a program. Use growsurf_client_snippets for a broader browser integration or growsurf_grsf_config_snippet for page-level participant auto authentication.

growsurf_grsf_config_snippetB

Generate the HTML code for GrowSurf Participant Auto Authentication using window.grsfConfig. The generated code belongs in <head>, before the GrowSurf Universal Code.

growsurf_get_integration_connect_linkA

Return a dashboard link to an integration's connect panel in the GrowSurf Program Editor (Options > Integrations). Connecting Stripe, PayPal, Wise, or another account requires the user to complete the dashboard flow; the API cannot connect an account on their behalf. integration accepts supported keys, including camelCase keys such as constantContact and helpScout. The result reports whether the integration is connected, enabled, or autoDisabled. If the program check cannot run, programVerified is false and the result still includes a production dashboard link. Tango Card, Tremendous, Bask Health, CareValidate, MD Integrations, Lithos, and Telegra apply only to referral programs. Wise applies only to affiliate programs. Targets campaignId if supplied, otherwise GROWSURF_CAMPAIGN_ID.

Prompts

Interactive templates invoked by user choice

NameDescription
create_referral_programCreate and configure a GrowSurf referral program from the proven referral template.
create_affiliate_programCreate and configure a GrowSurf affiliate program from the proven affiliate template.
embed_referral_widgetProduce the installation plan and snippets for adding GrowSurf to a web app.
list_campaignsList GrowSurf programs so you can choose the right campaign id.
get_campaignFetch one GrowSurf program by campaign id.
list_participantsList participants in a GrowSurf program.
get_participantFetch one GrowSurf participant by id or email.
set_rewardsSafely review and adjust GrowSurf reward configs.
wire_webhooksPlan and configure GrowSurf webhooks for product automation.
read_analyticsAnalyze GrowSurf campaign or participant performance.
advise_program_designRecommend a referral or affiliate program design for a business before creating or changing rewards.
troubleshoot_referral_trackingDiagnose why referrals, participants, rewards, or emails are not behaving as expected.

Resources

Contextual data attached and managed by the client

NameDescription
GrowSurf Agent and Developer IndexFirst-party links for understanding, integrating, and automating GrowSurf.

TDQS

A3.7/5.0

Scored across 71 tools

Disambiguation4/5

Most tools target a clearly distinct resource and action, such as campaign config tabs, rewards, groups, participants, webhooks, and analytics. There is some potential overlap among the many guide/snippet tools and among the several analytics and campaign-update tools, but the descriptions provide enough boundaries to distinguish them.

Naming Consistency4/5

The tools consistently use a `growsurf_` prefix and snake_case, with most CRUD tools following a verb_noun pattern. A few names are noun phrases rather than verb-led, such as `growsurf_participant_auth_hash`, `growsurf_mobile_sdk_guide`, and `growsurf_grsf_config_snippet`, but the convention remains mostly predictable.

Tool Count2/5

With 71 tools, the surface is very large for a single MCP server and likely to overwhelm agents during tool selection. While the platform is broad and many tools map to real operations, several guide, snippet, and evaluation helpers could be separated or consolidated to keep the core toolset manageable.

Completeness4/5

Coverage is extensive across campaigns, configuration tabs, rewards, groups, participants, analytics, webhooks, program resources, custom domains, teams, integrations, referrals, sales, and payouts. The main visible gaps are the absence of a campaign delete tool and only bulk participant deletion rather than a single-participant delete operation.

Maintenance

ActivityActive
ResponsivenessLimited data