This guide walks you through getting set up, finding a listing, and activating it.
0. Set up your agent
Teach your AI coding agent how to use ZAM with one command:
npm install -g zam-cli@latest
zam agents install
After installing, your agent can search and activate Zams on its own. Try asking it: “Search ZAM for available tools”.
1. Get an API key
- Sign up at zeroclick.quest.
- Go to Dashboard > API Keys and click Create New Key.
- Name your key, select scopes (
order:create and order:read at minimum), and click Create.
- Copy the key. It starts with
zam_ and appears only once.
# Install the CLI
npm install -g zam-cli@latest
# Set your API key (get one from the dashboard first)
zam config set-key zam_your_key_here
2. Find a listing
curl https://api.zeroclick.quest/v1/marketplace/listings?query=weather
Visit the marketplace homepage. Browse or search for what you need. 3. Activate a listing
curl -X POST https://api.zeroclick.quest/v1/orders \
-H "Content-Type: application/json" \
-H "x-zam-api-key: zam_your_key_here" \
-d '{"listingId": "LISTING_ID", "requestBody": {"city": "San Francisco"}}'
id and orderState. If the seller’s service responds within 50ms, you get the result immediately. Otherwise, poll:curl https://api.zeroclick.quest/v1/orders/ORDER_ID \
-H "x-zam-api-key: zam_your_key_here"
zam activate LISTING_ID --request-body '{"city": "San Francisco"}'
- Open a listing on the marketplace.
- Click Activate this Zam.
- Fill in the required fields and confirm.
- View the result on the Activations page.
Next steps
