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

# IA y MCP

> Conecta agentes de IA al servidor MCP de Whop para llamar a la API y buscar en la documentación, con inicio de sesión en el navegador y reintentos idempotentes.

El servidor Model Context Protocol (MCP) de Whop permite que los agentes de IA trabajen con datos reales de Whop y busquen en esta documentación desde una sola conexión.

> [!TIP]
>
> Claude Code y Grok tienen un plugin de Whop que instala este servidor por ti.
> Consulta [Claude Code](https://docs.whop.com/es/developer/guides/plugins/claude-code.md) y [Grok](https://docs.whop.com/es/developer/guides/plugins/grok.md).

## Servidor MCP de Whop

Permite que los agentes de IA llamen a la API actual: listar recursos, crear datos y explorar tu configuración de forma interactiva. También busca y lee esta documentación, para que los agentes consulten la API actual mientras construyen. URL del servidor: `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"
		}
	}
}
```

### Una URL para todos los clientes

Todos los clientes se conectan a la URL `/mcp`. Los clientes con revisiones anteriores del protocolo usan la misma URL sin ninguna configuración especial.

> [!NOTE]
>
> Si te conectaste con la URL `/sse`, cámbiala a `/mcp`. El endpoint `/sse` se ha retirado y ahora devuelve un 404.

### Autenticación

El servidor inicia tu sesión a través del navegador, así que toda la configuración del cliente es una URL. No añadas una clave de API, un token de portador ni una cabecera de autorización personalizada. En el primer uso, tu navegador abre la pantalla de inicio de sesión de Whop, que enumera los alcances que solicita la conexión. Whop guarda las credenciales en el servidor. Nunca llegan a la configuración de tu cliente ni al modelo.

### A qué puede acceder una conexión

El permiso se concede a ti, no a un negocio concreto. El contexto del negocio es un parámetro de cada operación, así que el agente lo elige en cada llamada. Las herramientas disponibles son un subconjunto revisado de la API. Se excluyen los endpoints que necesitan una sesión propia de whop.com.

> [!WARNING]
>
> Cada llamada a una herramienta se ejecuta cuando el agente la hace, así que tu cliente MCP decide qué apruebas. Las herramientas de pagos, credenciales y acciones destructivas llevan `destructiveHint`, que los clientes usan para preguntarte primero. Conecta solo clientes MCP de confianza, revisa las acciones que propone un agente y desconecta el acceso cuando ya no lo necesites.

### Reintentos e idempotencia

El `idempotency_key` es una clave estable que eliges para que un reintento se reproduzca en lugar de volver a ejecutarse. El servidor la envía a la API como la cabecera `Idempotency-Key`. Tras un resultado incierto, reintenta con la misma clave. No cambies nunca a una clave nueva hasta haber verificado lo que ocurrió.

### Conectarse desde Claude.ai

1. Abre [Claude](https://claude.ai).
2. Abre **Settings** y luego **Connectors**.
3. Selecciona **Add custom connector**.
4. Introduce la URL del servidor: `https://mcp.whop.com/mcp`

Para desconectarte, haz lo mismo: abre el conector y elimínalo. El permiso deja de funcionar inmediatamente.

### Cuando falla el inicio de sesión

| Lo que ves | Qué ocurrió |
| - | - |
| This sign-in attempt expired. Start over. | El intento estuvo demasiado tiempo en espera. Vuelve a iniciar la conexión. |
| Un 403 al final del inicio de sesión | El inicio de sesión empezó en un navegador y terminó en otro. Completa todo el flujo en un solo navegador. |
| `invalid_grant` | La credencial de Whop de la conexión ya no es válida. Vuelve a conectarte para autorizarla de nuevo. |

## Acceso a archivos planos para agentes

Si no tienes un cliente MCP, [docs.whop.com/llms.txt](https://docs.whop.com/llms.txt) indexa cada página tal y como las agrupa la navegación de la documentación, y añadir `.md` a cualquier URL de la documentación devuelve el Markdown sin procesar.

## Próximos pasos

> [card] [Descripción general de la API](https://docs.whop.com/es/api-reference/overview.md)
>
> Cómo funcionan las solicitudes, el versionado y la paginación.

> [card] [Inicio rápido](https://docs.whop.com/es/developer/quickstart.md)
>
> Haz tu primera llamada a la API en pocos minutos.

> [card] [Probar en el sandbox](https://docs.whop.com/es/developer/guides/sandbox.md)
>
> Prueba con claves de API del sandbox antes de pasar a producción. El servidor MCP solo accede a producción.

> [card] [Whop CLI](https://docs.whop.com/es/cli/overview.md)
>
> Crea y gestiona apps de Whop desde tu terminal.


## Related topics

- [Herramientas de IA para construir en Whop](https://docs.whop.com/es/developer/ai/overview.md)
- [Crear con la CLI y Claude](https://docs.whop.com/es/developer/guides/cli-with-claude.md)
- [Plugin de Whop para Claude Code](https://docs.whop.com/es/developer/guides/plugins/claude-code.md)
