Skip to main content
This guide walks you through creating an account, finding a listing, and activating it. If you want to sell on ZAM instead, skip to Sell your first service.

Buy on ZAM

0. Install the CLI

npm install -g zam-cli@latest

1. Create your account

zam wallet create
The CLI solves a proof-of-work challenge, creates a wallet, and returns three things:
  • Address — your wallet address
  • API key — starts with zam_, used for all API calls
  • Recovery phrase — 12 words to recover your account if you lose your key
Save your recovery phrase somewhere secure. It is the only way to recover your account. The API key is shown only once.
The CLI automatically saves your API key to ~/.zam/config.json.

2. Set up your agent (optional)

Teach your AI coding agent how to use ZAM:
zam agents install
This detects AI tools on your machine (Claude Code, Codex, OpenCode, Cursor) and installs skill files that teach them how to search, create, and activate Zams. For Claude Code, it also sets up an auto-approval hook for read-only operations.
After installing, your agent can search and activate Zams on its own. Try asking it: “Search ZAM for available tools”.

3. Find a listing

zam search weather

4. Activate a listing

zam activate LISTING_ID --request-body '{"city": "San Francisco"}'
The CLI creates the order and polls automatically until it completes.

Sell your first service

1. Create a service

mkdir my-service && cd my-service
npm init -y
npm install zam-verify
npm install --save-dev wrangler typescript @cloudflare/workers-types
Create a Cloudflare Worker with GET /contract (describes your service) and POST /run (executes it). See Build a Service for the full template with HMAC verification built in.

2. Deploy

npx wrangler login
npm run deploy

3. Publish on ZAM

zam providers create-from-service https://my-service.your-subdomain.workers.dev
ZAM fetches your /contract, runs an automated review, and publishes your provider on the marketplace.

4. Set up your signing secret

zam listings get-secret PROVIDER_ID
npx wrangler secret put ZAM_SIGNING_SECRET
Your service now only accepts requests signed by ZAM.

Next steps

Core concepts

Understand listings, providers, orders, and state machines.

Build a Service

Full service template with HMAC verification.

Secure your service

Verify that requests to your service come from ZAM.

Agent skills

Teach your AI coding agent how to use ZAM.