Dice Roll

What is Dice Roll?

An MCP (Model Context Protocol) server that simulates dice rolls using standard dice notation and Fate/Fudge dice. It provides tools for parsing dice notation strings and generating random results, designed for use with MCP-compatible clients like Claude Desktop.

How to use Dice Roll?

Install globally with npm install -g server-dice-roll or run directly via npx -y server-dice-roll. Configure in Claude Desktop by adding the server to mcpServers in the configuration file. The server exposes two tools: parse_dice_roll_notation (parses a notation string to structured data) and dice_roll (rolls dice based on a configuration and returns results).

Key features of Dice Roll

• Parses standard dice notation strings (e.g., 2d6, 1d20+5)
• Supports both standard dice and Fate/Fudge dice
• Generates random dice rolls with accurate probability distributions
• Validates input and output using Zod schemas
• Seamlessly integrates with any MCP-compatible client

Use cases of Dice Roll

• Add dice rolling to a tabletop RPG assistant via Claude Desktop
• Simulate Fate/Fudge dice rolls for narrative games
• Parse and validate dice notation in applications that need structured roll data
• Enable random number generation through MCP for automation tools

FAQ from Dice Roll

What dice notation formats are supported?

Standard notation NdS+M (e.g., 2d10, 3d8+5) and Fate dice notation NdF (e.g., 4dF). The number of dice defaults to 1 if omitted, and the modifier is optional.

How do I install and run this server?

Install globally via npm install -g server-dice-roll and run mcp-server-dice-roll, or use npx -y server-dice-roll without installation. Configure in Claude Desktop by adding the server block with "command": "npx", "args": ["-y", "server-dice-roll"].

Can I parse a dice notation string without rolling?

Yes, use the parse_dice_roll_notation tool. It takes a notation string like "3d6+4" and returns a structured object with type, count, sides, and modifier.

What are Fate/Fudge dice and how do I use them?

Fate dice are 6-sided with two sides each of -1, 0, and +1. Use NdF notation (e.g., 4dF). The server's dice rolling tool accepts type: "fudge" in the configuration.

Does this server require any external service or authentication?

No. The server runs locally over stdio MCP transport and has no authentication. All dice rolls are generated locally without external dependencies.