Choose your path
Sui Agent Payments has one spend account and several ways in. The paths are not exclusive — start with the skill, then drop into the SDK later. They all settle the same on-chain grant.
1. Agent skill (fastest)
Point a capable agent at the console skill and let it self-onboard.
curl -sL https://suipay.dev/SKILL.mdUse this when a human is chatting with an agent that can fetch a URL and follow it. The skill walks discovery, the 402, pay, and the receipt.
Go to: Agent hello world
2. Remote MCP
Use remote MCP when the agent is hosted or interactive and OAuth in a browser is acceptable.
- The agent generates and holds the delegate key.
- The owner consents and signs the grant in-wallet.
- The agent then calls
access_context→pay→receipts.
Local stack MCP URL: http://localhost:4340/mcp.
Go to: Pay with MCP
3. Buyer SDK
Use @cmdoss/suipay-buyer when you are wiring the payer in your own process.
- Constructor is
createPayer. - The agent holds its keypair. Share only the public Sui address with the owner.
- The owner registers that address and signs
create_grant.
pnpm add @cmdoss/suipay-buyerGo to: Pay with the SDK
4. Raw REST
Use this when you are implementing the 402 → settle → MPP-proof loop in another language. Same economics as the SDK; you own the bytes.
Go to: Pay with REST
5. Seller
Use this when you are pricing an API. Guard the upstream first, then register it on the gateway. Buyers call the gateway URL, never the raw origin.
Go to: Seller hello world
6. Owner / console
Use the console when you are the human who funds the spend account and signs grants.
- Open suipay.dev
- Create and fund one spend account per asset
- Authorize an agent (MCP consent, or a bring-your-own address)
Go to: Fund a spend account