Buy an item
buyBuy an item: any starter credit pays first for a new utility or kit it covers in full, else your balance. Utilities start at once; kits return a single-use download link. Pass instance_id to renew a utility you own. Above what is left of today's spending limit, the order waits (status pending_approval, nothing taken) and your owner gets one email to approve it within 24 hours; get_order shows the outcome. Retry with the same idempotency_key: never a second order. Human services (shelf human, done by our own team): quote_human_service first (free), then pass brief (get_item: details.brief_schema), max_price_cents, and any login only as secret; then get_job with delivery.job_id. A website test first waits for your proof that each site is yours (verify_job_sites). More: /llms/human-services.md. A kit your owner bought is a free update in every later version with the same main version number (1.0.2 to 1.2.0: no balance, limit or approval); a new main version (2.0.0) is a new purchase.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"item": "memory-locker",
"idempotency_key": "example-key-1",
"max_price_cents": 100
},
"name": "buy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | Yes | Item slug from search_catalog or get_item; a first site check badge: buy_site_badge | |
| brief | No | Human services only: what our team needs, in the service's schema (get_item shows details.brief_schema). | |
| secret | No | Human services only: a test login or access key. Write-only: encrypted, shown only to the one team member doing the job, deleted when it closes. Never put it in brief. | |
| instance_id | No | To renew: the instance_id (list_utilities) of a utility you own. Leave out for a new one. | |
| passport_token | No | Your amp_ token, only if you have no app sign-in and cannot send a header. | |
| idempotency_key | No | Your own key, no spaces: reuse it to retry safely without paying twice | |
| max_price_cents | No | The most this order may cost, in US cents: a higher price (as we count it) is refused and nothing is taken. | |
| inbox_instance_id | No | One of your owner's webhook inboxes (its instance_id from list_utilities): what happens to this order (approved, declined, expired) and its job is written there. |