vandewilly avatar

Dice Roller

vandewilly/mcp-dice-roller

This server gives Claude dice rolling capabilities through six tools: roll_dice for standard notation like 2d6 or 1d20+5 with keep highest/lowest modifiers, roll_multiple for repeated rolls with statistics, roll_dnd_stats for 4d6 drop lowest ability score generation, flip_coin, pick_random for choosing from comma separated options, and roll_percentile for d100 rolls. Each tool returns structured JSON with the rolls, kept dice, modifiers, and totals. Reach for this when you need tabletop RPG mechanics in your Claude workflow, whether that's generating D&D characters, resolving game actions, or making weighted random decisions. Install via pip and run through stdio transport.

tools
6
transport
STDIO
last updated
Dec 10, 2025

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

roll_diceRoll dice using standard notation.

Roll dice using standard notation.

No parameter schema in public metadata yet.

roll_multipleRoll the same dice multiple times with statistics.

Roll the same dice multiple times with statistics.

No parameter schema in public metadata yet.

roll_dnd_statsGenerate D&D 5e character ability scores.

Generate D&D 5e character ability scores.

No parameter schema in public metadata yet.

flip_coinFlip a coin.

Flip a coin.

No parameter schema in public metadata yet.

pick_randomPick randomly from options.

Pick randomly from options.

No parameter schema in public metadata yet.

roll_percentileRoll d100 (percentile dice).

Roll d100 (percentile dice).

No parameter schema in public metadata yet.

Sponsors

Readme

MCP Dice Roller 🎲

A simple MCP (Model Context Protocol) server for rolling dice. Perfect for tabletop games, random decisions, and more!

Features

  • Standard Dice Notation - Roll any dice using notation like 2d6, 1d20+5, 3d8-2
  • Keep Highest/Lowest - Support for 4d6kh3 (keep highest 3) and 2d20kl1 (keep lowest)
  • D&D Stat Rolling - Quick character stat generation using 4d6 drop lowest
  • Coin Flips - Simple heads or tails
  • Random Picker - Choose randomly from a list of options
  • Percentile Dice - Roll d100 with tens and ones dice

Installation

pip install mcp-dice-roller

Usage

With Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "dice-roller": {
      "command": "python",
      "args": ["-m", "mcp_dice_roller"]
    }
  }
}

With VS Code

Add to your VS Code MCP settings:

{
  "mcp.servers": {
    "dice-roller": {
      "command": "python",
      "args": ["-m", "mcp_dice_roller"]
    }
  }
}

Tools

roll_dice


View the full README on GitHub

Details

Repository
github.com/vandewilly/mcp-dice-roller
Package
mcp-dice-roller
Transport
STDIO
Registry
MCP registry, active