SolvaPay SDK

TypeScript SDK for monetizing APIs, AI agents, and MCP servers — paywall protection, checkout UI, and purchase management.

Configure with npx solvapay@latest init or npm create solvapay@latest -- --type mcp · Integrate with Express, Next.js, Supabase Edge, or MCP · Monetize with paywalls, checkout, and usage metering.

Quickstart

Existing project — auth + env

npx solvapay@latest init

New paid MCP app (recommended)

npm create solvapay@latest my-mcp-app -- --type mcp

Try an example (no API key)

git clone https://github.com/solvapay/solvapay-sdk
cd solvapay-sdk && pnpm install && pnpm build
cd examples/express-basic && pnpm dev   # stub mode — no API key needed

Skills for coding agents

Using Claude Code, Codex, Cursor, or other AI coding agents?

Install the SolvaPay skills and describe what you want to build — the router picks the right workflow (MCP app, SDK integration, checkout, etc.).

npx skills add solvapay/skills

Integration paths

Packages

The SDK ships 10 published npm packages:

Each package README is the npm landing page for that surface. See docs/contributing/architecture.md for contributor architecture notes.

Usage at a glance

Server paywall — see @solvapay/server:

import { createSolvaPay } from '@solvapay/server'

const solvaPay = createSolvaPay({ apiKey: process.env.SOLVAPAY_SECRET_KEY })
const payable = solvaPay.payable({ product: 'prd_YOUR_PRODUCT' })

app.post('/tasks', payable.http(handler))       // Express
export const POST = payable.next(handler)      // Next.js App Router

Client checkout — see @solvapay/react:

import { SolvaPayProvider, CheckoutLayout } from '@solvapay/react'

<SolvaPayProvider>
  <CheckoutLayout productRef="prd_myapi" prefillCustomer={{ email }} />
</SolvaPayProvider>

Next.js API routes — see @solvapay/next (not duplicated here).

Supabase Edge — one-liner handlers via @solvapay/server/fetch.

Examples

See examples/README.md for setup instructions.

Documentation

• TypeScript SDK — integration guides and API reference
• Architecture — package design (contributors)
• Contributing — development workflow

Development

pnpm install
pnpm build
pnpm test

The monorepo uses Changesets for per-package versioning. See CONTRIBUTING.md for branching, preview publishes, and release workflow.

Security

API keys never reach the browser. Payment flows run through backend routes. Webhook signature verification is included.

Found a vulnerability? See SECURITY.md.

License

MIT — see LICENSE.md.

Support

• Issues: GitHub Issues
• Email: contact@solvapay.com
• Docs: docs.solvapay.com