Connect your AI assistant to Cluby

1. Server address

Paste this address wherever your assistant asks for an MCP server URL:

Protocol

Model Context Protocol (MCP)

Transport

Streamable HTTP, stateless, with JSON responses. The server answers POST requests only; there is no SSE stream and no session to keep alive.

2. Signing in

The server uses OAuth 2.1. When you add it, your assistant opens a Cluby page where you sign in with your normal Partner Hub account and confirm access. You never paste a password or key into the assistant.

Alternative: API key

Scripts and tools that cannot open a browser can send a Cluby API key as a bearer token instead. Create one under Profile → API keys in the Partner Hub. An API key grants the same access as a sign-in, so treat it like a password.

3. Set up in your assistant

Menu names change from time to time. If you cannot find these options, search your assistant's help for “MCP connector”.

claude mcp add --transport http cluby https://api.cluby.com/v2/mcp

{
  "mcpServers": {
    "cluby": {
      "url": "https://api.cluby.com/v2/mcp"
    }
  }
}

{
  "servers": {
    "cluby": {
      "type": "http",
      "url": "https://api.cluby.com/v2/mcp"
    }
  }
}

[mcp_servers.cluby]
url = "https://api.cluby.com/v2/mcp"

4. What the assistant can do

Most tools only read, and return the same figures you see in the Partner Hub. The last five make changes, the same ones you could make yourself in the Partner Hub: importing an image, creating and editing a benefit, and creating and editing a birthday gift.

5. Access and permissions

• The connection acts as you. It can see and do exactly what your Partner Hub account can, and nothing else. It cannot be widened beyond your own access.
• Its only changes are creating and editing benefits and birthday gifts and importing images for them, and only in venues where you are an admin or owner. It cannot delete anything, send push messages or touch payouts.
• Access cannot currently be narrowed to a single organization or venue. Each tool call names one organization, but the connection itself covers everything your account covers.
• Each team member connects with their own account, so their assistant sees only what their own role allows.
• Connections expire automatically after 90 days.

Removing access

Every connection appears under Profile → API keys in the Partner Hub, named after the app that requested it. Revoke it there and the assistant loses access immediately. Removing the connector inside the assistant does not revoke it on Cluby's side, so do both.

6. Your data

What is shared with the assistant

Only what a tool returns for a question: organization and venue names, aggregate statistics, and the definitions of your benefits, events and cards. Recent activity entries carry an anonymous member identifier, never a name, email address or phone number.

Once a result reaches the assistant, it is handled under that provider's terms: Anthropic for Claude, OpenAI for ChatGPT. Check the provider's data settings if you need results kept out of model training.

What Cluby keeps

Cluby does not store your conversations or the questions the assistant asks. Each request is processed and answered on the spot. We keep the same request logs as for any other Partner Hub use, and for each connection its name, creation date, expiry and last-used time. Benefits, birthday gifts and images the assistant creates or changes are saved like any you make in the Partner Hub.

Policies

• Privacy notice
• Merchant terms and conditions