From solvapay-skills
Integrate the SolvaPay TypeScript SDK into an existing app -- Next.js, React, Express, Supabase Edge Functions, Deno, or an MCP server that already exists. Use when the user says "integrate sdk", "protect api", "paywall my api", "usage events", "webhooks", "add solvapay to existing mcp", "supabase edge functions", "npx solvapay init", or wants account-management UI (CurrentPlanCard, LaunchCustomerPortalButton, usePaymentMethod). Covers paywall enforcement, usage tracking, hosted checkout, customer portal, plan activation / cancellation / reactivation, and webhook signature verification. Use the `create-mcp-app` skill instead when scaffolding a brand-new paid MCP server.
How this skill is triggered — by the user, by Claude, or both
Slash command
/solvapay-skills:sdk-integrationThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Add SolvaPay to an existing TypeScript / JavaScript app via the `@solvapay/*` packages.
Add SolvaPay to an existing TypeScript / JavaScript app via the @solvapay/* packages.
package.json (see Stack Detection Rules).npx -y solvapay@latest init to authenticate and install base packages (@solvapay/server, @solvapay/core, @solvapay/auth).Detect stack from package.json:
next dependency present → follow references/nextjs.mdreact present and next absent → follow references/react.md plus backend contractexpress present → follow references/express.md@modelcontextprotocol/* present → follow references/mcp-server.mdsupabase/functions/ directory exists OR @supabase/supabase-js present without next/express → follow references/supabase-edge.mdAsk one question if any of these are missing:
npx -y solvapay@latest init to authenticate and install base SDK packages.npx -y solvapay@latest init to authenticate, set SOLVAPAY_SECRET_KEY in .env, add .env to .gitignore, and install base packages: @solvapay/server, @solvapay/core, @solvapay/auth.@solvapay/next, @solvapay/react, @solvapay/react-supabase).SOLVAPAY_SECRET_KEY only on server).Topics: typescript sdk intro, installation, quick start, core concepts.
Topics: custom auth, nextjs auth middleware, customer.
activatePlan as an alternative to checkout.cancelRenewal and reactivateRenewal.activatePlan with a different plan — the old purchase is automatically expired.Topics: checkout sessions, customer sessions, limits, usage, purchase management, activate plan.
Topics: webhooks, verify signature, purchase events, payment events.
Topics: test in sandbox, go live, testing, error handling.
SOLVAPAY_SECRET_KEY to client code or public env vars.create-mcp-app instead.lovable-checkout instead.website-checkout covers the minimal slice.When this domain completes, provide:
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub solvapay/skills --plugin solvapay-skills