GrowSurf MCP server
Give an AI assistant a way to run a referral or affiliate program over the Model Context Protocol. It is an interface over the GrowSurf REST API, not a separate product: anything it can do, the REST API can do. If your assistant can send HTTPS requests, you do not need MCP at all.
Hosted server
Point a compatible MCP client at the hosted endpoint:
https://mcp.growsurf.comThe client completes OAuth while you sign in to GrowSurf, pick a team, and approve the requested scopes. Your assistant never handles an API key. The connection acts only on the team you selected, and API-key rotation is deliberately not available through MCP.
Manual Claude connector setup
For normal setup, connect from the GrowSurf listing in the Claude directory. If you need a custom connector instead, use these steps. For Claude Desktop, use the same Claude account.
- Open Customize → Connectors. On Team or Enterprise, an organization owner must first add the connector under Organization settings → Connectors.
- Select + Add, then Add custom connector, and name it GrowSurf. Organization owners choose Add → Custom → Web.
- Enter
https://mcp.growsurf.comas the remote MCP server URL. - Select Continue, review the detected authentication settings, then select Continue again.
- Choose Sign in now and, under OAuth client, Register automatically. Select Add, then sign in to GrowSurf and approve access. If needed, select Connect first.
- In a conversation, use + → Connectors to enable GrowSurf.
Discovery metadata
- OAuth Protected Resource Metadata — RFC 9728
- OAuth Authorization Server Metadata — RFC 8414
Local server and CLI
The same tools run locally over stdio from the official npm package, which also provides the GrowSurf CLI:
npx -y @growsurfteam/growsurf-mcpSet GROWSURF_API_KEY in the client configuration. Optionally set GROWSURF_CAMPAIGN_ID to default program-scoped tools to one program; it is not a credential, and an explicit campaignId argument overrides it.
Read the CLI guide for commands, or the growsurf-mcp source on GitHub.
Sign up first
The account owner signs up at app.growsurf.com (no credit card required) and verifies their email address. Then they connect the hosted server with OAuth, or create an API key in GrowSurf Settings for the local server.
Public read-only endpoint
GrowSurf also publishes a credential-free Streamable HTTP endpoint for public resources at growsurf.com/.well-known/mcp, described by its MCP server card. Use it to read GrowSurf's first-party agent and developer index without signing in.
Before you connect
A credential proves permission, not intent. Confirm with the account owner before anything destructive or irreversible.
Ask the owner first
- Deleting participants
- Deleting rewards
- Refunding a sale
- Fulfilling a reward
Keep a new program in DRAFT until the owner approves launch.
See auth.md for the full credential-handling rules, and Build with AI for the customer-facing overview.

Webhooks
