stripekit

The create-next-app of Stripe. One command takes an app from zero to working payments on your Stripe account: it provisions your catalog from a config file in your repo, and drops in correct-by-construction billing code you own. No hosted service. No revenue share. Nothing to depend on at runtime. Works identically whether a human or an agent runs it.

Documentation →

Repository layout

Path	What it is
`packages/stripekit`	The `stripekit` npm package — CLI + config API.
`examples/playground`	A scratch project to try stripekit against a Stripe test account.
`docs`	The VitePress documentation site.
`DESIGN.md`	The MVP design: CLI surface, config schema, generated code, build order.

Status

Reconciler (plan / push / pull) — reconciles your Stripe account to a declarative stripe.config.ts (products, prices, webhook endpoint, customer portal), treating prices as immutable, archiving instead of deleting, and converging idempotently.
init — scaffolds stripe.config.ts plus correct-by-construction billing code (webhook handler, state sync, checkout/portal routes) into a Next.js App Router app.
dev — wraps stripe listen to forward webhooks locally and capture the signing secret.
check — a doctor that verifies keys, config validity, config-vs-account drift, and webhook/portal wiring.

There's also a VitePress docs site with a landing page — run pnpm docs:dev. Roadmap (see DESIGN.md): init support beyond Next.js and richer catalog features.

See the package README for usage.

For AI agents

stripekit is built to be driven by agents, not just humans:

llms.txt and llms-full.txt — the docs as clean markdown for LLM context.
SKILL.md — point your coding agent at this and it can set stripekit up for you.
stripekit mcp — an MCP server exposing plan/push/pull/check as tools an agent can call.
Every command accepts --json and --yes for deterministic, non-interactive use.

Install the MCP server one-click in Cursor:

…or in Claude Code as a plugin:

bash

/plugin marketplace add rafaelcg/stripekit
/plugin install stripekit@stripekit-marketplace

See the MCP docs for other clients (Claude Desktop, .cursor/mcp.json, claude mcp add).

Working on stripekit? See AGENTS.md.

Develop

bash

pnpm install
pnpm -C packages/stripekit build      # bundle CLI + types
pnpm -C packages/stripekit test       # unit + integration tests
pnpm -C packages/stripekit typecheck

License

MIT