MCP SERVERRun a live PlayFab title from the conversation — search and publish catalog items, grant or subtract player inventory, ban and unban accounts, and set the title-wide config keys the game reads.
LABSCO SUMMARY
Delete_item is documented as removing an item from every player inventory that holds it, and set_title_data writes configuration all players can see. The details in the tool descriptions that will trip a first integration are the identifier and the currency model: inventory calls want a TitlePlayerAccountId rather than the PlayFabId that comes back from login, and in Economy v2 a virtual currency is an item, so a grant carries an item ID and not a currency code. Against that, the design is careful where it matters — the catalog has a draft version that publish_draft_item promotes, IdempotencyId is a parameter on the inventory writes, and execute_inventory_operations is atomic across the batch it is given. ban_users reaching IPAddress and MACAddress is worth knowing before an agent is allowed to call it, since that blocks a device rather than an account.
A server over PlayFab's Economy v2 catalog, player inventory, segment, account and title-data APIs, exposing catalog authoring, per-player inventory writes, moderation and global configuration as callable tools.
A PlayFab title and its developer secret key, supplied as PLAYFAB_TITLE_ID and PLAYFAB_DEV_SECRET_KEY.
One command plus a key — npx -y @akiojin/playfab-mcp-server, then supply credentials
USE CASES
Take the segment that describes them, work through the player profiles inside it, convert the IDs into the form the inventory API takes, and grant the item.
Build the item as a draft, adjust it until it is right, and publish it as a separate deliberate step once it should be purchasable.
Pull the account, convert the ID, list the collections their inventory is split across, and read what is actually in them.
Ban with a duration and a reason on record, check the account afterwards, and lift it cleanly if the report turns out to be wrong.
Write the schedule or feature flag into the title data the game reads at runtime, and keep anything sensitive on the server-only side of it.
Check what the affected players are actually holding, then correct the whole batch in one request that either lands completely or not at all.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_inventory_itemsGrants items or virtual currency to a player's inventory. Use this when you need to: 1) Give rewards to players, 2) Add purchased items, 3) Grant virtual currency (use currency item ID). For bulk operations across multiple players, use grant_items_to_users instead. Note: In Economy v2, virtual currencies are items - use their item IDs, not currency codes.
ban_usersBans players from accessing the game. Use when: 1) Player violates terms, 2) Suspicious activity detected, 3) Temporary suspension needed. Can ban by: PlayFabId (specific player), IPAddress (block IP), MACAddress (block device). Set DurationInHours for temp bans, omit for permanent. Always include clear Reason for records.
create_draft_itemCreates a new draft item in the catalog. Draft items must be published before they can be used. Use this to: 1) Add new items to your game, 2) Create virtual currency items, 3) Define bundles. After creation, use publish_draft_item to make it available to players.
delete_inventory_itemsDeletes items from a player's inventory. You must specify the Item (InventoryItemReference object) and TitlePlayerAccountId. Warning: This permanently removes items from the player's inventory.
delete_itemPermanently deletes an item from the catalog. WARNING: This cannot be undone! The item will be removed from all player inventories.
execute_inventory_operationsExecute multiple inventory operations in a single batch request. Supports up to 50 operations per request. Operations are atomic - all succeed or all fail.
get_all_segmentsRetrieves an array of player segment definitions. Results from this can be used in subsequent API calls such as GetPlayersInSegment which requires a Segment ID. While segment names can change the ID for that segment will not change.
get_inventory_collection_idsRetrieves all inventory collection IDs for a specific player.Use this to list all collections before fetching items from them.
get_inventory_itemsRetrieves the current inventory items for a specific player.You must provide the TitlePlayerAccountId.You can optionally specify a collection (CollectionId), a page size (Count), and a ContinuationToken for pagination.
get_itemRetrieves detailed information about a specific catalog item. Returns both draft and published versions if available.
get_players_in_segmentsRetrieves a paginated list of player profiles in a specific segment.Use SegmentId to specify the segment. Use ContinuationToken for pagination.
get_title_dataRetrieves global configuration data for the title. Can retrieve specific keys or all title data.
get_title_internal_dataRetrieves server-only title data. This data is not accessible by game clients.
get_title_player_account_id_from_playfab_idConverts a PlayFabId to TitlePlayerAccountId. IMPORTANT: Use this before any inventory operations! PlayFabId (from login/user info) ≠ TitlePlayerAccountId (needed for inventory). Example flow: Get PlayFabId from user data → Convert with this tool → Use result for inventory APIs.
get_user_account_infoRetrieves detailed account information for a player. Includes profile data, statistics, and linked accounts.
get_user_dataRetrieves custom data stored for a player. Can retrieve specific keys or all data.
publish_draft_itemPublishes a draft item, making it available to players. Once published, the item can be purchased and used in the game.
revoke_all_bans_for_userRemoves all active bans for a specific player. This unbans the player completely.
search_itemsSearches for items in the PlayFab catalog (Economy v2). Use this when you need to find items by name, type, or other properties. Common uses: Finding all weapons, searching for items containing 'sword', filtering by price range. Returns item details including ID, name, description, and prices. Supports pagination for large result sets. Use the returned items' IDs with inventory management tools.
set_title_dataSets global game configuration visible to ALL players. Use for: 1) Game version info, 2) Event schedules, 3) Feature flags, 4) Global settings. Format: Key-value pairs. Value can be JSON string for complex data. WARNING: This is PUBLIC data - use set_title_internal_data for sensitive configs!
set_title_internal_dataSets server-only title data that is not accessible by clients. Use this for sensitive configuration like API keys, server settings, etc.
subtract_inventory_itemsSubtracts a specific amount of items from a player's inventory. Use this to reduce item quantities without completely removing them.
update_draft_itemUpdates an existing draft item in the catalog. Changes only affect the draft version until published.
update_inventory_itemsUpdates properties of existing inventory items. Use this to modify item metadata, display properties, or custom data.
update_user_dataUpdates custom data for a player. Can set multiple key-value pairs at once.
BEFORE YOU INSTALL
25 tools when we connected. 13 tools write to a live game title, including publish_draft_item, delete_item, ban_users and set_title_data, using a title-wide Developer Secret Key with no read-only mode.
CONTEXT COST
Rated by the size of the 25 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx -y @akiojin/playfab-mcp-server{
"mcpServers": {
"playfab": {
"command": "npx",
"args": [
"-y",
"@akiojin/playfab-mcp-server"
],
"env": {
"PLAYFAB_TITLE_ID": "<YOUR_PLAYFAB_TITLE_ID>",
"PLAYFAB_DEV_SECRET_KEY": "<YOUR_PLAYFAB_DEV_SECRET_KEY>"
}
}
}
}docker compose run --rm playfab-mcp-server bashMCP servers
mario-andreschak
AlyxPink
jacksmith3888
yuniko-software