Skip to content

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.

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.
  • Amounts are integers in a currency’s minor units (fiat 2 dp, stablecoins 6 dp).
  • Errors are a typed AgentbankError carrying status + 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, no node: builtins, so it runs on Vercel Edge / Cloudflare Workers.
  • Auth — merchants authenticate with their Curless API key as Authorization: Bearer.