whop-mcp

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.

✨ Features

• 🔐 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

⚙️ Quick Start

Install in VS Code

Install the whop-mcp server in VS Code with one click:

Note: Replace YOUR_WHOP_API_KEY_HERE with your actual Company API key from the Whop Developer Dashboard.

Install in Claude Desktop

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"
      }
    }
  }
}

Install in Cursor

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"
    }
  }
}

🔑 Getting Your API Key

1. Go to https://whop.com/dashboard/developer

2. Click Create in the Company API Keys section

3. Give your key a name (e.g. "Claude Integration")

4. Select the appropriate permissions (Payments, Memberships, Products, etc.)

5. Copy the key — you'll never see it again!

💰 Available Tools

💰 Payments & Finance

🪪 Memberships & Licenses

📦 Products & Catalog

🎟️ Promo Codes & Discounts

🤝 Affiliates

👥 Customers & Reviews

▶️ Example Prompts

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"

🔧 Development

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

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

📄 License

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.