Ensure the item and its price are configured in the Economy v2 catalog with a virtual currency price tag
POST to https://[titleId].playfabapi.com/Inventory/PurchaseInventoryItems with the player EntityKey, the Item to receive, and PriceAmounts listing the virtual-currency ItemId and Amount to deduct
Optionally specify StackId on both the price item and the received item to control which inventory stack is debited or credited
Verify the response TransactionIds and confirm inventory reflects the deduction and grant atomically
Use SubtractInventoryItems for direct deductions outside of catalog-price flows
Known gotchas
The deduction and grant are not wrapped in a cross-system ACID transaction; if the call partially fails, check TransactionIds and reconcile manually
PurchaseInventoryItems uses the catalog-defined price; if the catalog item has no matching currency price, the call returns a pricing error rather than charging zero
Ensure the player has sufficient virtual currency balance before calling; insufficient-funds errors are non-idempotent and do not roll back partial writes
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