Community-led MCP server for Whop.com Company API — manage payments, memberships, products, promo codes, and more via AI.
whop-mcp provides 28 tools with consistent naming (verb_noun pattern), reasonable descriptions (100-250 chars average), and complete input schemas. However, output schemas are entirely undocumented, error handling lacks recovery guidance, and there are no tool annotations (readOnlyHint/destructiveHint). Parameter descriptions are present but often generic. The server follows basic registration patterns but falls short of production-grade polish in schema transparency, error messaging, and agent-planning support.
Extend a membership by adding free days to it.
Cancel a membership at period end (member retains access until expiry).
Create a new product in your Whop company catalog.
Create a new promo code with discount configuration.
Delete a product from your catalog. This action is irreversible.
Permanently delete a promo code. This cannot be undone.
Output schemas completely undocumented. No tool returns a documented response schema, preventing LLM planning and field extraction.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Agents cannot distinguish safe tools from dangerous ones; missing WRITE/DESTRUCTIVE classification in schema.
Error handling lacks recovery guidance. No evidence of actionable error messages (e.g., 'Invalid status' errors do not suggest valid values; permission errors do not guide next steps).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | B | 71 | 2026-07-28+ | v2 |
| 2026-03-09 | D | 50 | - | v1 |
Get detailed statistics for a specific affiliate partner by their affiliate ID.
Get an aggregate summary of all affiliate performance: total sales, earnings, and top performers.
Get a high-level financial summary: total revenue, refunds, fees, and payment breakdown by status.
Get detailed information about a specific membership by its ID.
Get detailed information about a specific payment by its ID.
Get detailed information about a specific product including its plans and experiences.
Get detailed information about a specific promo code by its ID.
List all affiliate partners for your Whop company with their commission and earnings data.
List all memberships for your Whop company with optional filters.
List all payments for your Whop company with optional filters (status, product, date range, pagination).
List all pricing plans for a specific product.
List all products in your Whop company catalog, including plans and experiences.
List all promo codes for your Whop company, with optional filters.
Check server connectivity and uptime
Issue a full or partial refund for a payment. Use with caution — this action cannot be undone.
Retry a failed payment attempt for a given payment ID.
Immediately terminate a membership and revoke all access. This is permanent.
Update metadata or notes on a membership record.
Update an existing product's name, visibility, or description.
Update an existing promo code (e.g. disable it or change expiry).
Validate a license key and check if it maps to an active, valid membership.
Void an open or uncollected payment. The payment must not yet be collected.
update_membership accepts arbitrary 'metadata' object with no schema documentation. LLMs cannot know what keys are valid.
Destructive operations (terminate_membership, refund_payment, void_payment, delete_product, delete_promo_code) lack dry-run or confirmation step. Agents cannot ask for approval before executing irreversible actions.
Pagination parameters (page, per) lack constraints. No stated min/max for page number or per_page limit. Unbounded numeric parameters invite LLMs to pass invalid values.
add_free_days and refund_payment accept numeric 'days'/'amount' with no range documentation. Could allow negative or zero values.