SDKs
The merchant-side packages ship as public @curless/* packages on npm — everything you
need to accept agent payments. Pick the one for your job.
Packages
Section titled “Packages”Two ways a merchant sells to agents: sell products (a catalog checkout) with the merchant SDK, or sell per-call access to an API/tool with the paywall. Both land the money in your account.
| Package | For | What it does |
|---|---|---|
@curless/agentbank-merchant-sdk |
Merchants — sell products | Open a priced checkout (checkout.openACP/openUCP/openX402, chargeSkyfire, openMPP), read orders + balance transactions, handle refunds, verify webhooks. |
@curless/agentbank-mcp-pay |
Merchants — sell per-call | Wrap an existing API or MCP tool so each call is pay-to-use — withPaywall(handler, …). |
@curless/create-agentbank |
Everyone | npm create @curless/agentbank — scaffold a new merchant backend or paywall. |
@curless/cli |
Everyone | npx @curless/cli init — add agentbank (a storefront or a paywall) to an existing project. |
@curless/agentbank-merchant-mcp |
Merchants | Merchant stdio MCP — read orders + Curless balance + refunds in Claude Desktop. |
Conventions
Section titled “Conventions”- Amounts are integers in a currency’s minor units (fiat 2 dp, stablecoins 6 dp).
- Errors are a typed
AgentbankErrorcarryingstatus+code— catch that one class (error codes +.is()guidance). - Edge-safe where it matters — the SDKs’ crypto (e.g. the merchant SDK’s
verifyWebhook) is Web Crypto, nonode:builtins, so it runs on Vercel Edge / Cloudflare Workers. - Auth — merchants authenticate with their Curless API key as
Authorization: Bearer.

