Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@RPG MCP Server Roll 2d6 for damage."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A simple MCP (Model Context Protocol) server for playing RPGs with Large Language Models. It provides tools for dice rolling, success checks, and random event generation.
check_success(probability, critical_rate) - Determines success/failure with optional critical results
roll_dice(expr) - Rolls dice using standard RPG notation (e.g., '1d6', '2d8+3')
generate_event() - Generates random RPG events for plot twists and surprises
list_tools() - Lists all available tools
Related MCP server: Dice Roller MCP Server
Python 3
uv - A fast Python package installer
Clone the repository:
git clone https://github.com/jnaskali/rpg-mcp.git
cd rpg-mcpInstall dependencies with uv:
uv syncAdd the following to your MCP client's configuration file (e.g., mcp.json in Claude Desktop or other MCP-compatible clients):
{
"mcpServers": {
"rpg-mcp": {
"command": "/usr/bin/uv",
"args": [
"run",
"python",
"app.py"
],
"cwd": "/PATH_TO/rpg-mcp/"
}
}
}Replace /PATH_TO/rpg-mcp/ with the actual path to your rpg-mcp directory.
Once configured, the LLM can call the tools to:
Roll dice for attacks, damage, or skill checks
Determine action outcomes with customizable success probabilities
Generate random events to drive the narrative forward
Include instructions in your prompt like:
"Call check_success whenever a player character attempts something with a chance of failure, and generate_event to generate a random event at the start of a new scene or when moving to a new location."
The event generation system is inspired by Mythic Game Master Emulator.
Tool calling works best with models that support function calling, such as Claude, GPT-4, Mistral, Llama, or Qwen.
Test the server by asking the LLM to generate a random event. The unique format should make it clear whether the tool is working or if the LLM is hallucinating results.
Check for success based on a given probability.
Args: probability: Chance of success (0-100). Default 80. critical_success: Top % range for critical success (0-50). Default 5. critical_failure: Bottom % range for critical failure. Defaults to critical_success value.
Inputs: probability, critical_failure, critical_success.
Generate random addresses.
Inputs: count, locale.
Generate a random corporation name from the local file.
Inputs: no named parameters.
Generate a random abstract RPG event.
Inputs: no named parameters.
Generate random modern names. Args: count: Number of names (1-50). gender: 'male', 'female', or 'random'. locale: Locale code (e.g., 'en_US', 'de_DE', 'fr_FR').
Inputs: count, gender, locale.
Roll dice using RPG notation (e.g., '2d6', '1d20+5').
Inputs: expr (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool targets a distinct purpose: address generation, corporation generation, success checking, dice rolling, event generation, and name generation. There is no overlap between these functions, and check_success vs roll_dice are clearly different mechanics.
All tool names follow a verb_noun pattern. Four use the 'generate_' prefix, while the other two use clear action verbs ('check_success', 'roll_dice'). The naming is predictable and consistent in structure.
Six tools is well within the ideal range for an RPG assistant, covering both generation and resolution without unnecessary bloat. Each tool is useful and distinct, making the set well-scoped.
The set covers core RPG needs: dice rolling, probability checks, and varied random generation (names, events, addresses, corporations). Some possible additions like item or character generation are missing, but the essential workflows are present.
Play and build AI RPG worlds: your agent tells the story, Worldtable keeps HP, items and the map.
A persistent tabletop RPG with an AI dungeon master. Agents and humans share one table.
Fair, reproducible randomness for agents: dice, coins, integers, list picks, shuffles, with seeds.
Fair, reproducible randomness for agents: dice, coins, integers, list picks, shuffles, with seeds.
