PlayFab MCP Server

What is PlayFab MCP Server?

PlayFab MCP Server is middleware that enables large language models (such as Claude and VS Code) to interact directly with PlayFab services. It acts as a translator between AI assistants and PlayFab functionalities including item search, segment inquiries, player profile lookups, inventory management, and PlayFab ID conversion.

How to use PlayFab MCP Server?

Install Node.js 18+, obtain PlayFab Title ID and Developer Secret Key from PlayFab Game Manager, create a .env file with those credentials, run npm install and npm run build, then start with npm start. Configure your LLM client (e.g., Claude Desktop) with a JSON config pointing to the @akiojin/playfab-mcp-server npx command and your credentials.

Key features of PlayFab MCP Server

• Search items via PlayFab's search_items API
• Manage Economy v2 catalog (create, update, delete, publish draft items)
• Retrieve segment info and player profiles
• Convert PlayFab IDs to Title Player Account IDs
• Add, remove, subtract, and update inventory items
• Ban and unban players by ID, IP, or MAC address
• Set and get player custom data and title data

Use cases of PlayFab MCP Server

• Ask an AI assistant to "Show me the latest 10 items" and get results in plain text
• Manage player profiles, segments, and inventory without manual API calls
• Perform catalog operations like creating draft items and publishing them
• Ban or unban players using natural language requests
• Retrieve and update player custom data or title configuration

FAQ from PlayFab MCP Server

What runtime dependencies does PlayFab MCP Server require?

Node.js 18 or higher is required. A PlayFab account with a Title ID and Developer Secret Key is needed. A supported LLM client such as Claude Desktop is recommended.

How are PlayFab credentials handled?

Credentials are stored in a .env file as PLAYFAB_TITLE_ID and PLAYFAB_DEV_SECRET_KEY. They are also passed as environment variables when configuring the MCP server in your LLM client's config.

What transport does the server use?

The server runs on stdio, as indicated by the startup message "PlayFab Server running on stdio".

Does the server support batch inventory operations?

Yes, it supports execute_inventory_operations for batch inventory operations under Economy v2 administration.

Can I run PlayFab MCP Server in a container?

Yes, the repository includes a Docker Compose file with a Node 22 dev container. You can build the image and run the server inside the container.