Stores

Stores are curated subsets of the catalog. You can create multiple stores with different audiences, time-limited items, and price overrides.

Store features

Segment targeting — show stores to specific user segments
Price overrides — sale prices for specific store listings
Scheduling — time-limited items with available_from and available_until
Purchase limits — cap how many times each user can buy an item

MCP tools

Tool	Description
`amba_stores_create`	Create a store with optional segment targeting
`amba_stores_add_listing`	Add items to a store with overrides and scheduling

Example: Holiday sale

Agent: "Create a holiday store with discounted items"

amba_stores_create({
  project_id: "proj_xxx",
  name: "Holiday Sale",
  description: "Limited time holiday deals!"
})

amba_stores_add_listing({
  project_id: "proj_xxx",
  store_id: "store_xxx",
  catalog_item_id: "item_premium_theme",
  override_prices: { "gold": 100 },
  available_from: "2025-12-20T00:00:00Z",
  available_until: "2025-12-31T23:59:59Z",
  max_purchases_per_user: 1
})

Client API reference

Method	Path	Description
`GET`	`/client/stores`	List available stores
`GET`	`/client/stores/:id`	Get store listings

Store features

MCP tools

Example: Holiday sale

Client API reference

On this page