Skip to content
whopioPublic

About

No description, website, or topics provided.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

39 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Whop Skills

Agent skills that teach AI coding agents to build on Whop correctly: taking payments, verifying webhooks, managing memberships, paying people out, running a marketplace, building Whop apps, embedding chat, and migrating from Stripe.

Each skill follows the Agent Skills specification, so it works in Claude Code, Cursor, OpenCode, Codex, and any other agent that reads SKILL.md files. The plugin also connects the official Whop MCP server.

Skills

Skill Use it to
whop Start here: it inspects your project and picks the skill for your goal, even when you don't say "Whop"
whop-api Set up credentials and the SDK, use sandbox, and handle IDs, money units, pagination, errors and versioning
whop-checkout Take a payment: checkout links, the Checkout element, Express Checkout, products and variants
whop-billing Manage what happens after the sale: memberships, access checks, cancellations, invoices, refunds, disputes
whop-webhooks Receive and verify webhook events and fulfill orders exactly once
whop-payouts Move money out: transfers, payouts, the payout portal, ledgers
whop-platforms Run a marketplace with subaccounts, onboarding and verification
whop-apps Build apps that run inside Whop: app views, user auth, permissions, OAuth
whop-communities Embed chat and DMs, sync users, and work with channels, forums and courses
whop-operate Run your live store from the agent: products, checkout links, refunds, memberships, ads, websites and stats
whop-migrate Move to Whop from Stripe and others, or from older Whop API names

You don't call skills by name. Describe what you want ("add a Whop webhook that fulfills the order when a payment succeeds") and the agent loads the matching skill. Each skill works when installed alone; it falls back to the Whop docs where it would hand off to a skill you don't have.

If a skill gives wrong or outdated guidance, tell your agent. It drafts a skill-feedback issue with keys, IDs and customer data removed, and posts it only after you approve the text.

Commands, agents and checks

The plugin adds these on top of the skills.

Command Does
/whop-developer:connect Checks the Whop MCP sign-in (user, businesses, live account) and how it differs from the project's own API key and environment
/whop-developer:setup Installs the SDK, adds the env var names, writes a server-only client and proves it works with a real sandbox call
/whop-developer:test-webhook Sends signed test events to your running webhook handler: valid signature, tampered signature, duplicate delivery and the 5-second deadline
/whop-developer:audit Reviews the integration for leaked keys, unverified webhooks, missing idempotency keys, cents-vs-dollars bugs, client-side access checks and stale API names
Subagent Does
whop-integration-reviewer Read-only review with file:line findings by severity (used by /whop-developer:audit)
whop-migrator Rewrites old Whop code (@whop/api, API v2, plans, companies, withdrawals, cents) or a Stripe integration to the current API, and type-checks the result

Claude Code also runs three hooks:

  • Before a Whop MCP tool that moves money, changes credentials or deletes data runs (a refund, a cancellation, a deletion, a new webhook secret), it makes Claude Code ask you, even if you always allow the Whop tools. The server runs every tool on the first call, so this is where you approve. The model can't treat your original request as the approval. Reads and ordinary writes aren't affected. The list of tools comes from scripts/mcp-tools.json.

  • After every file edit, it checks the lines just written for names the current API replaced (plans.create, new Whop(, company_id, membership.went_valid...) and for unsafe code: a Whop key under NEXT_PUBLIC_ or in a "use client" file, a hard-coded ws_ secret, a parsed webhook body. It tells the agent the fix and the skill to load. Each finding is reported once per session.

  • At session start, in a project that already uses Whop, it tells the agent which Whop packages are installed, flags deprecated ones, and explains that the MCP server works on the live account and runs every tool on the first call. Other projects get nothing.

All three need Node 18+ and do nothing if it's missing. They read local files only and never send data anywhere. The webhook test script ships inside the whop-webhooks skill, so agents that install only the skills get it too.

Install

Claude Code

/plugin marketplace add whopio/skills
/plugin install whop-developer@whop-skills

GitHub Copilot CLI

copilot plugin marketplace add whopio/skills
copilot plugin install whop-developer@whop-skills

Codex

codex plugin marketplace add whopio/skills
codex plugin add whop-developer@whop-skills

Start a new Codex session after installing.

VS Code (GitHub Copilot): turn on the chat.plugins.enabled setting, run Chat: Install Plugin from Source from the Command Palette, and enter https://github.com/whopio/skills.

Antigravity

agy plugin install https://github.com/whopio/skills

Gemini CLI

gemini extensions install https://github.com/whopio/skills

Kimi Code: run /plugins install https://github.com/whopio/skills, then /reload. Sign in to the Whop MCP server with /mcp-config login when Kimi asks.

Cursor, and other plugin-aware tools (skills plus the MCP server):

npx plugins add whopio/skills

What each tool gets

Tool Skills MCP server Commands Subagents Hooks Rules Manifest
Claude Code ✓ ✓ ✓ ✓ ✓ .claude-plugin/plugin.json
Cursor ✓ ✓ ✓ ✓ ✓ .cursor-plugin/plugin.json
Kimi Code ✓ ✓ ✓ ✓ .kimi-plugin/plugin.json
Gemini CLI ✓ ✓ ✓ gemini-extension.json
Antigravity ✓ ✓ ✓ .antigravity-plugin/plugin.json + mcp_config.json
Codex ✓ ✓ .codex-plugin/plugin.json, listed in .agents/plugins/marketplace.json
GitHub Copilot (CLI and VS Code) and other Agent Plugins hosts ✓ ✓ plugin.json + mcp.json
Grok Build ✓ ✓ .grok-plugin/plugin.json

Where a tool has no subagents, /whop-developer:audit follows the reviewer's checklist itself. Cursor and Antigravity don't run the plugin's hooks, so they get the same checks as a rule (rules/whop.mdc, rules/whop.md) that the agent applies when it works on Whop code.

Skills only, into any agent (OpenCode, Claude Code, Cursor, Codex, and more):

npx skills add whopio/skills

Add -a <agent> to pick the agent, or --skill whop-checkout to install one skill.

Copy the skills by hand. Each skill is a folder with a SKILL.md. Codex, Cursor, OpenCode and Gemini CLI all read ~/.agents/skills/:

git clone --depth 1 https://github.com/whopio/skills.git /tmp/whop-skills
mkdir -p ~/.agents/skills && cp -R /tmp/whop-skills/skills/* ~/.agents/skills/

Or copy them into the folder your agent reads:

Agent All projects One project Docs
Claude Code ~/.claude/skills/ .claude/skills/ Skills
Codex ~/.agents/skills/ .agents/skills/ Skills
Cursor ~/.cursor/skills/ or ~/.agents/skills/ .cursor/skills/ or .agents/skills/ Skills
OpenCode ~/.config/opencode/skills/ or ~/.agents/skills/ .opencode/skills/ Skills
Gemini CLI ~/.gemini/skills/ or ~/.agents/skills/ .gemini/skills/ Skills

A hand copy doesn't include the MCP server, commands, subagents or hooks; add the MCP server as below.

Whop MCP server

One connection covers the API (acting on your live account) and the Whop docs (docs_search, docs_query), so there's no separate docs server. The plugin installs it for you. To add it by hand:

  • Claude Code: claude mcp add --transport http whop https://mcp.whop.com/mcp

  • OpenCode: add this to opencode.json, then run opencode mcp auth whop:

    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "whop": { "type": "remote", "url": "https://mcp.whop.com/mcp" }
      }
    }

The first call opens a browser window to sign in to Whop. See the MCP guide for other clients.

Operating a Whop business instead?

The whop-operate skill in this plugin runs a live store from your agent (refund a customer, launch a product, check revenue) through the same Whop MCP sign-in. The older whopio/plugins plugin and the whop CLI still work too.

Contributing

Read AGENTS.md for how skills are written and checked, and CONTRIBUTING.md for the pull request flow.

Privacy

The plugin connects to mcp.whop.com using your Whop login. Whop's privacy policy and terms apply.

License

Apache-2.0

About

No description, website, or topics provided.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages