Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@whop-mcp list my recent payments"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A community-built Model Context Protocol (MCP) server for the Whop.com Company API. It enables AI assistants (Claude, Cursor, etc.) to fully manage your Whop business — payments, memberships, products, promo codes, affiliates, and more.
🔐 Secure API key authentication via environment variable
📦 Full TypeScript with strict type-safety
🔄 Automatic retry & rate-limit handling
🛡️ Comprehensive error handling (401, 403, 404, 429)
🚀 Works with Claude Desktop, Cursor, and any MCP-compatible client
📡 stdio transport (works as a CLI binary or subprocess)
Related MCP server: VoIPBin MCP Server
Install the whop-mcp server in VS Code with one click:
Note: Replace
YOUR_WHOP_API_KEY_HEREwith your actual Company API key from the Whop Developer Dashboard.
Add to your Claude Desktop config file:
macOS/Linux: ~/.config/claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"whop": {
"command": "npx",
"args": ["-y", "@furkankoykiran/whop-mcp"],
"env": {
"WHOP_API_KEY": "YOUR_WHOP_API_KEY_HERE"
}
}
}
}Add to your Cursor MCP settings (Cursor Settings -> MCP Servers):
{
"whop": {
"command": "npx",
"args": ["-y", "whop-mcp"],
"env": {
"WHOP_API_KEY": "YOUR_WHOP_API_KEY_HERE"
}
}
}Click Create in the Company API Keys section
Give your key a name (e.g. "Claude Integration")
Select the appropriate permissions (Payments, Memberships, Products, etc.)
Copy the key — you'll never see it again!
Tool | Description |
| List payments with filters (status, product, date range, pagination) |
| Get full details of a specific payment |
| Issue a full or partial refund for a payment |
| Retry a failed payment attempt |
| Void an open/uncollected payment |
| High-level revenue, refund, and fee summary |
Tool | Description |
| List memberships with filters (status, product, user, validity) |
| Get full membership details including license key and expiry |
| Validate a license key and check if its membership is active |
| Extend a membership by adding free days |
| Cancel a membership at period end |
| Immediately revoke a membership |
| Update metadata on a membership |
Tool | Description |
| List all products with plans and experiences |
| Get full product details, plans, and experiences |
| Create a new product |
| Update product name, visibility, or description |
| Delete a product permanently |
| List all pricing plans for a product |
Tool | Description |
| List all promo codes with optional status filter |
| Get details of a specific promo code |
| Create a new discount code (% or $ off) |
| Update an existing promo code (status, expiry, etc.) |
| Permanently delete a promo code |
Tool | Description |
| List all affiliates with commission and earnings data |
| Get detailed stats for a specific affiliate |
| Aggregate affiliate program performance with top performers |
Tool | Description |
| Look up a Whop user by username or user ID |
| Find customers by email address |
| Fetch customer reviews with optional star rating filter |
| Aggregate review statistics (avg rating, distribution) |
Once connected, you can ask your AI assistant:
"Show me all payments from the last 30 days"
"Refund payment pay_123abc"
"Add 7 free days to membership mem_456def"
"Create a 20% off promo code called SUMMER20 that expires December 31, 2025"
"What's my average customer review rating?"
"Who are my top 5 affiliates by earnings?"
"Validate license key ABC-1234-XYZ"
# Install deps
npm install
# Run in dev mode (auto-reload)
npm run dev
# Build
npm run build
# Test manually
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | WHOP_API_KEY=test node dist/index.jsContributions are welcome! Please see CONTRIBUTING.md for guidelines.
This project is licensed under the MIT License.
⚠️ Disclaimer: This is a community-led project and is NOT an official Whop.com product. It is not affiliated with, endorsed by, or supported by Whop.com. Always test in a non-production environment before running actions like refunds or membership terminations.
Extend a membership by adding free days to it.
Inputs: membership_id (required), days (required).
Cancel a membership at period end (member retains access until expiry).
Inputs: membership_id (required).
Create a new product in your Whop company catalog.
Inputs: name (required), visibility, description, headless.
Create a new promo code with discount configuration.
Inputs: code (required), discount_type (required), discount_amount (required), currency, +4 more.
Delete a product from your catalog. This action is irreversible.
Inputs: product_id (required).
Permanently delete a promo code. This cannot be undone.
Inputs: promo_code_id (required).
Get detailed statistics for a specific affiliate partner by their affiliate ID.
Inputs: affiliate_id (required).
Get an aggregate summary of all affiliate performance: total sales, earnings, and top performers.
Inputs: no named parameters.
Get a high-level financial summary: total revenue, refunds, fees, and payment breakdown by status.
Inputs: company_id, after_date, before_date.
Get detailed information about a specific membership by its ID.
Inputs: membership_id (required).
Get detailed information about a specific payment by its ID.
Inputs: payment_id (required).
Get detailed information about a specific product including its plans and experiences.
Inputs: product_id (required).
Get detailed information about a specific promo code by its ID.
Inputs: promo_code_id (required).
Get aggregate review statistics for your company: average rating, distribution by star count.
Inputs: product_id.
Look up a Whop user by their username or numeric user ID.
Inputs: identifier (required).
List all affiliate partners for your Whop company with their commission and earnings data.
Inputs: status, page, per.
List all memberships for your Whop company with optional filters.
Inputs: product_id, plan_id, user_id, status, +3 more.
List all payments for your Whop company with optional filters (status, product, date range, pagination).
Inputs: company_id, product_id, plan_id, status, +6 more.
List all pricing plans for a specific product.
Inputs: product_id (required).
List all products in your Whop company catalog, including plans and experiences.
Inputs: visibility, page, per.
List all promo codes for your Whop company, with optional filters.
Inputs: status, page, per.
Fetch the latest customer reviews left for your Whop company or a specific product.
Inputs: product_id, min_rating, page, per.
Check server connectivity and uptime
Inputs: no named parameters.
Issue a full or partial refund for a payment. Use with caution — this action cannot be undone.
Inputs: payment_id (required), amount, reason.
Retry a failed payment attempt for a given payment ID.
Inputs: payment_id (required).
Search for Whop users who have purchased from your company, filtered by email address.
Inputs: email (required).
Immediately terminate a membership and revoke all access. This is permanent.
Inputs: membership_id (required).
Update metadata or notes on a membership record.
Inputs: membership_id (required), metadata.
Update an existing product's name, visibility, or description.
Inputs: product_id (required), name, visibility, description.
Update an existing promo code (e.g. disable it or change expiry).
Inputs: promo_code_id (required), status, quantity, expiry_date.
Validate a license key and check if it maps to an active, valid membership.
Inputs: license_key (required).
Void an open or uncollected payment. The payment must not yet be collected.
Inputs: payment_id (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 32 tools
Each tool targets a distinct action on a specific resource. Cancel vs. terminate memberships and refund vs. void payments are clearly differentiated by description. No overlapping tool purposes.
The vast majority use a consistent verb_noun pattern in snake_case (e.g., create_product, list_memberships). The only exception is 'ping', which is a single verb and slightly breaks the pattern.
32 tools is above the typical 3-15 range but appropriate for a comprehensive commerce platform covering products, memberships, payments, affiliates, reviews, promo codes, users, and licenses. Slightly over but reasonable given the scope.
The tool set provides complete CRUD and lifecycle coverage for all major entities: products, memberships, payments, promo codes, affiliates, reviews, and users. Missing operations like update_affiliate are minor and non-essential.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Hosted WooCommerce MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
