Item Catalog

The item catalog defines all purchasable items in your app. Items can be durable (owned forever), consumable (used up), or bundles (contain other items).

Item types

Type	Description	Example
`durable`	Owned permanently	Themes, avatars, character skins
`consumable`	Used up on use	Extra lives, boosts, hints
`bundle`	Contains multiple items	Starter pack, holiday bundle

MCP tools

Tool	Description
`amba_create_catalog_item`	Create a catalog item
`amba_list_catalog`	List items (optionally by category)
`amba_set_item_price`	Set a price in a virtual currency

Example: Set up an item catalog

Agent: "Create a theme shop with gold pricing"

amba_create_catalog_item({
  project_id: "proj_xxx",
  key: "theme_dark",
  name: "Dark Theme",
  description: "A sleek dark theme for your app",
  category: "themes",
  item_type: "durable"
})

amba_set_item_price({
  project_id: "proj_xxx",
  catalog_item_id: "item_xxx",
  currency_code: "gold",
  price: 200
})

amba_create_catalog_item({
  project_id: "proj_xxx",
  key: "extra_life",
  name: "Extra Life",
  category: "powerups",
  item_type: "consumable"
})

Client API reference

Method	Path	Description
`GET`	`/client/catalog`	Browse catalog items
`POST`	`/client/catalog/:id/purchase`	Purchase an item

Database tables

Table	Purpose
`catalog_items`	Item definitions with key, type, category, tags, metadata
`catalog_prices`	Prices by currency for each item

Item types

MCP tools

Example: Set up an item catalog

Client API reference

Database tables

On this page