PlayFab MCP Server
About
PlayFab MCP Server is a middleware that enables large language models (such as Claude and VS Code) to interact directly with PlayFab services. Acting as a secure translator, it connects AI assistants with PlayFab functionalities like item search, segment inquiries, player…
Details
- Author
- MCP-Mirror
- Downloads
- 308
- Categories
- Other
Jump to
- Search items using PlayFab's search_items API
- Retrieve comprehensive segment information
- Query player profiles within specified segments
- Get current inventory items with get_inventory_items
- Fetch inventory collection IDs via get_inventory_collection_ids
- Convert a PlayFab ID to a Title Player Account ID
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PlayFab MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via Smithery or manually with Node.js 14+. Obtain your PlayFab Title ID and Developer Secret Key, then create a .env file with those credentials. Run npm install, npm run build, and npm start to start the server on stdio. Configure your LLM client (e.g., Claude Desktop or Cursor) to point to the server using the appropriate MCP configuration entries.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"playfab mcp server": {
"akiojin_playfab-mcp-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@akiojin/playfab-mcp-server",
"--client",
"claude"
]
}
}
}
}McpServers
{
"akiojin_playfab-mcp-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@akiojin/playfab-mcp-server",
"--client",
"claude"
]
}
}PlayFab MCP Server
What Is This? 🤔
This server is a middleware that enables large language models (like Claude and VS Code) to interact directly with PlayFab services. Acting as a secure and efficient translator, it connects your AI assistant with various PlayFab functionalities, such as item search, segment inquiries, player profile lookups, inventory management, and PlayFab ID conversion.
Quick Example
You: "Show me the latest 10 items."
Claude: calls the PlayFab search_items API and returns the results in plain text
How Does It Work? 🛠️
This server leverages the Model Context Protocol (MCP) to establish a universal interface between AI models and PlayFab services. Although MCP is designed to support any AI model, it is currently available as a developer preview.
Follow these steps to get started:
1. Set up your project.
2. Add your project details to your LLM client's configuration.
3. Start interacting with PlayFab data naturally!
What Can It Do? 📊
- Search for items using PlayFab's search_items API.
- Retrieve comprehensive segment information.
- Query player profiles within specified segments.
- Retrieve current inventory items with the get_inventory_items API.
- Fetch inventory collection IDs using the get_inventory_collection_ids API.
- Convert a PlayFab ID to a Title Player Account ID via the get_title_player_account_id_from_playfab_id API.
Quick Start 🚀
Installing via Smithery
To install PlayFab MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @akiojin/playfab-mcp-server --client claude
Prerequisites
- Node.js 14 or higher.
- A valid PlayFab account (obtain your Title ID and Developer Secret Key via PlayFab Game Manager).
- A supported LLM client such as Claude Desktop.
Set Up Your Project
Obtain your PlayFab Title ID and Developer Secret Key from the PlayFab Game Manager, then create a .env file in the project root with the following content (replace the placeholders with your actual credentials):
PLAYFAB_TITLE_ID=
PLAYFAB_DEV_SECRET_KEY=
Getting Started
1. Install Dependencies
In the project root, run the following command to install all necessary dependencies:
npm install
2. Build the Project
Compile the project by executing:
npm run build
3. Start the Server
Navigate to the dist folder and start the server with:
npm start
4. Confirmation Message
Upon startup, you should see this message:
PlayFab Server running on stdio
Running with Cursor
To use the PlayFab MCP server with Cursor, follow these steps:
1. Install Cursor Desktop if you haven't already.
2. Open a new instance of Cursor in an empty folder.
3. Copy the mcp.json file from this repository into your folder and update the values according to your environment.
4. Launch Cursor; the PlayFab MCP Server should appear in the tools list.
5. For example, try a prompt like "Show me the latest 10 items" to verify that the server processes your query correctly.
Adding Your Project Details to Claude Desktop's Config File
Open Claude Desktop and navigate to File → Settings → Developer → Edit Config. Then, replace the claude_desktop_config file content with the following snippet:
{
"mcpServers": {
"playfab": {
"command": "node",
"args": [ "C:/Path/To/playfab-mcp/dist/index.js" ], // Specify the path to your PlayFab MCP server file
"env": {
"PLAYFAB_TITLE_ID": "Your PlayFab Title ID",
"PLAYFAB_DEV_SECRET_KEY": "Your PlayFab Developer Secret Key"
}
}
}
}
With these steps, you have successfully configured the PlayFab MCP server for use with your LLM client, allowing seamless interaction with PlayFab's services.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
