# Whop — how to use (mcp.ai)

Connect your Whop account and use 19 tools for ecommerce straight from your AI agent. Connect with your own API key. Making everyone an internet entrepreneur. Explore a playground for digital products, memberships & communities.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_whop?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `whop_create_access_token`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/whop`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/whop/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/whop/create/access/token` — Tool to create a short-lived access token for authenticating API requests. Use when you need to generate temporary credentials for Whop's web and mobile embedded components.
  - body: { user_id?: string, company_id?: string, expires_at?: string, scoped_actions?: string[] }
- `POST https://api.mcp.ai/api/whop/create/file` — Tool to create a new file record and receive a presigned URL for uploading content to S3. Use when you need to upload files to Whop.
  - body: { filename: string }
- `POST https://api.mcp.ai/api/whop/delete/promo/code` — Tool to archive a promo code, preventing it from being used in future checkouts. Use when you need to deactivate or remove a promo code from circulation. Existing memberships created with this promo c
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/list/apps` — Tool to retrieve a paginated list of apps on the Whop platform. Use when you need to browse or search for apps with optional filtering by company, type, verification status, or view support. Supports 
  - body: { last?: integer, after?: string, first?: integer, order?: string, query?: string, before?: string, app_type?: string, direction?: string, view_type?: string, company_id?: string, verified_apps_only?: boolean }
- `POST https://api.mcp.ai/api/whop/list/authorized/users` — Tool to retrieve a paginated list of authorized team members for a company. Use when you need to view company team members, check user permissions, or audit team access. Supports filtering by company,
  - body: { last?: integer, role?: string, after?: string, first?: integer, before?: string, user_id?: string, company_id?: string, created_after?: string, created_before?: string }
- `POST https://api.mcp.ai/api/whop/list/members` — Tool to retrieve a paginated list of members for a company. Use when you need to view company members with optional filtering by product, plan, status, access level, and more. Supports cursor-based pa
  - body: { last?: integer, after?: string, first?: integer, order?: string, query?: string, before?: string, plan_ids?: string[], statuses?: string[], user_ids?: string[], direction?: string, company_id?: string, product_ids?: string[], access_level?: string, created_after?: string, created_before?: string, promo_code_ids?: string[], most_recent_actions?: string[] }
- `POST https://api.mcp.ai/api/whop/list/memberships` — Tool to retrieve a paginated list of memberships with filtering options. Use when you need to list memberships by product, plan, status, user, or promo code.
  - body: { last?: integer, after?: string, first?: integer, order?: string, before?: string, plan_ids?: string[], statuses?: string[], user_ids?: string[], direction?: string, company_id?: string, product_ids?: string[], created_after?: string, cancel_options?: string[], created_before?: string, promo_code_ids?: string[] }
- `POST https://api.mcp.ai/api/whop/list/payment/methods` — Tool to retrieve a paginated list of payment methods for a member or company. Use when you need to view stored payment information such as cards, bank accounts, or digital wallets. Either member_id or
  - body: { last?: integer, after?: string, first?: integer, before?: string, direction?: string, member_id?: string, company_id?: string, created_after?: string, created_before?: string }
- `POST https://api.mcp.ai/api/whop/list/payments` — Tool to retrieve a paginated list of payments for a company. Use when you need to view payment history with optional filtering by product, plan, status, billing reason, currency, and creation date. Su
  - body: { last?: integer, after?: string, first?: integer, order?: string, before?: string, plan_ids?: string[], statuses?: string[], direction?: string, company_id?: string, currencies?: string[], product_ids?: string[], substatuses?: string[], include_free?: boolean, created_after?: string, created_before?: string, billing_reasons?: string[] }
- `POST https://api.mcp.ai/api/whop/retrieve/app` — Tool to retrieve the details of an existing app. Use when you need to get information about a specific Whop app by its ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/retrieve/authorized/user` — Tool to retrieve the details of an existing authorized user. Use when you need to get information about a specific authorized user by their ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/retrieve/company` — Tool to retrieve the details of an existing company. Use when you need to fetch company information including settings, team details, verification status, and social links.
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/retrieve/company/token/transaction` — Tool to retrieve the details of an existing company token transaction. Use when you need to view information about a specific token transaction including amount, type, and associated user/member/compa
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/retrieve/file` — Tool to retrieve the details of an existing file from Whop. Use when you need to get information about a specific file by its ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/retrieve/member` — Tool to retrieve detailed information about an existing member by ID. Use when you need to get a specific member's details including their status, access level, spending history, and associated user i
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/retrieve/plan` — Tool to retrieve information about an existing plan. A plan defines pricing and billing terms for a product.
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/retrieve/promo/code` — Tool to retrieve the details of an existing promo code by its unique identifier. Use when you need to fetch information about a specific promo code's discount settings, usage limits, and restrictions.
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/retrieve/user` — Tool to retrieve the details of an existing user from Whop. Use when you need to get information about a specific user by their ID or username.
  - body: { id: string }
- `POST https://api.mcp.ai/api/whop/update/plan` — Tool to update a plan's pricing, billing interval, visibility, stock, and other settings. Use when you need to modify an existing plan's configuration such as changing prices, adjusting billing period
  - body: { id: string, stock?: integer, title?: string, currency?: string, visibility?: string, description?: string, custom_fields?: object[], initial_price?: number, renewal_price?: number, billing_period?: integer, internal_notes?: string, expiration_days?: integer, unlimited_stock?: boolean, override_tax_type?: string, trial_period_days?: integer, offer_cancel_discount?: boolean, payment_method_configuration?: object, strike_through_initial_price?: number, strike_through_renewal_price?: number }

## Example prompts
- "What can I do in Whop?"
- "Show me a summary of my Whop account"

## More
- Page: https://mcp.ai/whop
- Agent spec (llms.txt): https://mcp.ai/whop/llms.txt
- Postman collection: https://mcp.ai/whop/postman.json