MCPlayerOne

MCPlayerOne provides an MCP Game Server that lets you generate and play AI-generated worlds alongside ready-made game experiences. You can connect instantly through public endpoints or run and develop your own server locally, using familiar package tools to start, test, and customize your gameplay experience.

How to use

Connect to the MCP Game Server using either the public SSE endpoint or a local dev instance, then guide your agent to start or create a game. You can launch a quick session, pick a game, or generate a new one based on themes you provide. Use the available MCP tools to list stories, start games, move characters, inspect locations, and interact with items.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

# Install dependencies for the local server
npm install

# Start the local MCP server in development mode
npm run dev

Additional sections

Configuration and access methods include a public HTTP/SSE endpoint and local development options. Use the public endpoint to connect from any compatible client, or run the server locally to customize endpoints, environment variables, and tool access.

Public MCP server access information is provided below as connection options. The SSE endpoint for remote access is https://mcplayerone.onrender.com/api/v1/mcp/sse, and the OpenAPI spec can be accessed at https://mcplayerone.onrender.com/api/v1/mcp/openapi.json for tooling and integration details.

For local development, the recommended start command is npm run dev, which runs the server in development mode and exposes the local SSE endpoint at http://localhost:3000/api/v1/mcp/sse and the OpenAPI spec at http://localhost:3000/api/v1/mcp/openapi.json.

If you prefer to connect through a tool or IDE, you can configure an HTTP MCP server connection or a stdio (local) run as shown in the connection configs below.

Available tools

listStories

List all available game stories that can be played.

createGame

Generate a new game story, locations, items, and cover image by theme.

startGame

Start a new game session for a user in a specific story, or resume if started.

getGameState

Get the current state of the game (player and location) for a user and story.

lookAround

Get details about the player's current location (description, items, exits).

movePlayer

Move the player to a new location (by target ID) if valid.

takeItem

Pick up a specified item from the current location.

examineTarget

Get a detailed description of a specific item or feature in the current room.

getLeaderboard

Retrieve the leaderboard data for a specific story.

getStoryById

Get the details of a specific story by its logical ID.