Amba
Virtual Economy

Stores

Curated storefronts with segment targeting, scheduling, and purchase limits.

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

ToolDescription
amba_create_storeCreate a store with optional segment targeting
amba_add_store_listingAdd items to a store with overrides and scheduling

Example: Holiday sale

Agent: "Create a holiday store with discounted items"

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

amba_add_store_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

MethodPathDescription
GET/client/storesList available stores
GET/client/stores/:idGet store listings

Database tables

TablePurpose
storesStore definitions with name, segment target
store_listingsItems listed in stores with overrides and scheduling

Previous

Item Catalog

Next

Player Inventory

On this page