TypeScript SDK - Sumvin

Private preview: this is rolling out and may not be available on your account yet.

@sumvin/sdk is the TypeScript SDK for the Sumvin API. It gives you every API operation as a typed function, plus a small layer on top: authentication, one way to handle errors, and a reader for the limits a Stamped Mandate carries. The SDK is open source at github.com/Sumvin/sdk-ts and published on npm as @sumvin/sdk.

Two jobs

Act for a person

Sign in as a person and read or revoke their Stamped Mandates and connected agents.

Check a mandate

An agent shows you a Stamped Mandate. Check it offline and online before you act on it.

Who can use what today

Part	Who can use it today
Act for a person	Sumvin’s own apps and approved clients. Personal access tokens are not yet open to third-party apps. If you are building your own agent, connect it through the MCP connector or the CLI instead.
Check a mandate	Any site can check a token addressed to its own website, with no key. Checks addressed to an organisation need a key from the developer dashboard, which is by invitation during the preview. These checks are plain HTTP calls and a standard JWT library; the SDK has no verification function yet. The SDK’s ceiling reader helps you read what a mandate allows.

Next

Install

Add the package and check your runtime.

Verifier quickstart

Get a key, then check a mandate offline and online.