Authenticate to PlayFab using the title's secret key for server-side calls, or the player's session ticket for client-side calls, against the appropriate title ID
Use the Economy v2 CreateDraftItem API to define a new catalog item with type (CatalogItem, Bundle, Store, UGC, or Subscription), display properties, prices in virtual or real currencies, and content references
Call PublishDraftItem with the item's ID to make it live and visible to players; draft items are not purchasable until published
For player purchases, call PurchaseInventoryItems with the item ID and the currency and price to debit; the operation is atomic — currency deduction and item grant succeed or fail together
Call GetInventoryItems with the player's entity key to retrieve the player's current inventory, filtering by collection ID if multiple item collections are in use
Use AddInventoryItems or SubtractInventoryItems for server-side administrative adjustments, such as granting compensation or removing fraudulently obtained items
Known gotchas
Economy v2 uses Entity Keys (not the older PlayFab Player ID format) for all inventory operations; mixing the old and new identity systems causes not-found or permission errors
Draft items are invisible to players and non-purchasable; publishing is a required explicit step and there is no auto-publish on creation
PurchaseInventoryItems requires the exact price and currency to match the catalog item's configured price; a mismatch returns a price-mismatch error rather than adjusting to the listed price
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp