> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# AI en MCP

> Verbind AI-agents met de Whop MCP-server om de API aan te roepen en de documentatie te doorzoeken, met aanmelden via de browser en idempotente herhaalpogingen.

Met de Whop Model Context Protocol (MCP)-server kunnen AI-agents via één verbinding met live Whop-data werken en deze documentatie doorzoeken.

> [!TIP]
>
> Claude Code en Grok hebben een Whop-plugin die deze server voor je installeert.
> Zie [Claude Code](https://docs.whop.com/nl/developer/guides/plugins/claude-code.md) en [Grok](https://docs.whop.com/nl/developer/guides/plugins/grok.md).

## Whop MCP-server

Hiermee kunnen AI-agents de Current API aanroepen: resources opvragen, data aanmaken en je setup interactief verkennen. De server doorzoekt en leest ook deze documentatie, zodat agents de actuele API kunnen opzoeken terwijl ze bouwen. Server-URL: `https://mcp.whop.com/mcp`

```bash Claude Code theme={null}
claude mcp add --transport http whop-api https://mcp.whop.com/mcp
```

```json Cursor theme={null}
// Global: ~/.cursor/mcp.json (or per project: .cursor/mcp.json)
{
	"mcpServers": {
		"whop": {
			"type": "http",
			"url": "https://mcp.whop.com/mcp"
		}
	}
}
```

### Eén URL voor elke client

Alle clients maken verbinding met de `/mcp`-URL. Clients met oudere protocolversies gebruiken dezelfde URL zonder speciale configuratie.

> [!NOTE]
>
> Heb je verbinding gemaakt via de `/sse`-URL, wijzig die dan in `/mcp`. Het `/sse`-endpoint is uitgefaseerd en retourneert nu een 404.

### Authenticatie

De server meldt je aan via de browser, dus de hele clientconfiguratie bestaat uit een URL. Voeg geen API-sleutel, bearer token of aangepaste autorisatieheader toe. Bij het eerste gebruik opent je browser het aanmeldscherm van Whop, met de scopes die de verbinding aanvraagt. Whop bewaart de inloggegevens server-side. Ze komen nooit in je clientconfiguratie of bij het model terecht.

### Waar een verbinding bij kan

De toegang geldt voor jou, niet voor één bedrijf. De bedrijfscontext is een parameter bij elke bewerking, dus de agent kiest die per aanroep. De beschikbare tools vormen een gecontroleerde subset van de API. Endpoints die een first-party whop.com-sessie vereisen, zijn uitgesloten.

> [!WARNING]
>
> Elke toolaanroep wordt uitgevoerd zodra de agent die doet, dus je MCP-client bepaalt wat je goedkeurt. Tools voor betalingen, inloggegevens en destructieve acties hebben `destructiveHint`, waarmee clients je eerst om toestemming vragen. Verbind alleen MCP-clients die je vertrouwt, controleer de acties die een agent voorstelt en trek de toegang in wanneer je die niet meer nodig hebt.

### Herhaalpogingen en idempotentie

De `idempotency_key` is een stabiele sleutel die je zelf kiest, zodat een herhaalpoging het eerdere resultaat terugspeelt in plaats van opnieuw uit te voeren. De server stuurt hem naar de API als de header `Idempotency-Key`. Probeer het na een onzekere uitkomst opnieuw met dezelfde sleutel. Stap nooit over op een nieuwe sleutel voordat je hebt gecontroleerd wat er is gebeurd.

### Verbinden vanuit Claude.ai

1. Open [Claude](https://claude.ai).
2. Open **Settings** en daarna **Connectors**.
3. Selecteer **Add custom connector**.
4. Voer de server-URL in: `https://mcp.whop.com/mcp`

Verbreek de verbinding op dezelfde manier: open de connector en verwijder hem. De toegang werkt dan direct niet meer.

### Als aanmelden mislukt

| Wat je ziet | Wat er is gebeurd |
| - | - |
| This sign-in attempt expired. Start over. | De poging heeft te lang stilgestaan. Start de verbinding opnieuw. |
| Een 403 aan het einde van het aanmelden | Het aanmelden is in de ene browser gestart en in een andere afgerond. Doorloop de hele flow in één browser. |
| `invalid_grant` | De Whop-inloggegevens van de verbinding zijn niet meer geldig. Maak opnieuw verbinding om opnieuw te autoriseren. |

## Toegang via platte bestanden voor agents

Heb je geen MCP-client, dan indexeert [docs.whop.com/llms.txt](https://docs.whop.com/llms.txt) elke pagina op dezelfde manier als de navigatie van de documentatie ze groepeert, en als je `.md` toevoegt aan een docs-URL, krijg je de ruwe Markdown terug.

## Volgende stappen

> [card] [API-overzicht](https://docs.whop.com/nl/api-reference/overview.md)
>
> Hoe requests, versiebeheer en paginering werken.

> [card] [Quickstart](https://docs.whop.com/nl/developer/quickstart.md)
>
> Doe binnen een paar minuten je eerste API-aanroep.

> [card] [Testen in de sandbox](https://docs.whop.com/nl/developer/guides/sandbox.md)
>
> Test met sandbox-API-sleutels voordat je live gaat. De MCP-server werkt alleen met productie.

> [card] [Whop CLI](https://docs.whop.com/nl/cli/overview.md)
>
> Bouw en beheer Whop-apps vanuit je terminal.


## Related topics

- [AI-tools om op Whop te bouwen](https://docs.whop.com/nl/developer/ai/overview.md)
- [Bouwen met de CLI en Claude](https://docs.whop.com/nl/developer/guides/cli-with-claude.md)
- [Whop-plugin voor Claude Code](https://docs.whop.com/nl/developer/guides/plugins/claude-code.md)
