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., "@MCP Dice Roller roll 4d6 drop lowest six times for my character stats"
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 rolling dice. Perfect for tabletop games, random decisions, and more!
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
Related MCP server: Dice MCP Server
pip install mcp-dice-rollerAdd 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"]
}
}
}Add to your VS Code MCP settings:
{
"mcp.servers": {
"dice-roller": {
"command": "python",
"args": ["-m", "mcp_dice_roller"]
}
}
}Roll dice using standard notation.
roll_dice("2d6") → Roll two 6-sided dice
roll_dice("1d20+5") → Roll d20 and add 5
roll_dice("4d6kh3") → Roll 4d6, keep highest 3
roll_dice("2d20kl1") → Roll 2d20, keep lowest (disadvantage)Example Response:
{
"notation": "2d6+3",
"rolls": [4, 6],
"kept": [4, 6],
"subtotal": 10,
"modifier": 3,
"total": 13
}Roll the same dice multiple times with statistics.
roll_multiple("1d20", 5) → Roll d20 five timesExample Response:
{
"notation": "1d20",
"times": 5,
"totals": [15, 8, 20, 3, 12],
"statistics": {
"min": 3,
"max": 20,
"sum": 58,
"average": 11.6
}
}Generate D&D 5e character ability scores.
Example Response:
{
"method": "4d6 drop lowest",
"stats": [
{"rolls": [4, 3, 5, 6], "kept": [4, 5, 6], "total": 15},
{"rolls": [2, 4, 4, 3], "kept": [3, 4, 4], "total": 11},
...
],
"totals": [15, 11, 14, 13, 10, 16],
"sum": 79
}Flip a coin.
flip_coin() → Flip once
flip_coin(10) → Flip 10 timesPick randomly from options.
pick_random("pizza, burger, sushi, tacos")Example Response:
{
"options": ["pizza", "burger", "sushi", "tacos"],
"selected": "sushi",
"total_options": 4
}Roll d100 (percentile dice).
Example Response:
{
"tens_die": 7,
"ones_die": 3,
"result": 73
}# Clone the repository
git clone https://github.com/vandewilly/mcp-dice-roller.git
cd mcp-dice-roller
# Install dependencies
pip install -e ".[dev]"
# Run tests
pytestpython -m mcp_dice_rollerMCP Name: io.github.vandewilly/dice-roller
This server is published to the MCP Registry.
MIT License - see LICENSE for details.
Vandewilly Silva (@vandewilly)
Flip a coin one or more times.
Args: times: Number of times to flip (1-100)
Returns: Results of the coin flip(s)
Inputs: times.
Pick a random option from a comma-separated list.
Args: options: Comma-separated list of options (e.g., "pizza, burger, sushi")
Returns: The randomly selected option
Inputs: options (required).
Roll dice using standard dice notation (e.g., '2d6', '1d20+5', '3d8-2').
Args: notation: Dice notation string. Examples: - '1d6' - Roll one 6-sided die - '2d6' - Roll two 6-sided dice - '1d20+5' - Roll one 20-sided die and add 5 - '3d8-2' - Roll three 8-sided dice and subtract 2 - '4d6kh3' - Roll 4d6, keep highest 3 (D&D stat rolling) - '2d20kl1' - Roll 2d20, keep lowest 1 (disadvantage)
Returns: Dictionary with rolls, modifier, and total
Inputs: notation.
Roll a set of D&D 5e character stats using the standard 4d6 drop lowest method.
Returns: Six ability scores rolled using 4d6, dropping the lowest die
Inputs: no named parameters.
Roll the same dice multiple times.
Args: notation: Dice notation (e.g., '1d20+5') times: Number of times to roll (1-20)
Returns: Dictionary with all roll results and statistics
Inputs: times, notation.
Roll percentile dice (d100).
Returns: A random number from 1 to 100
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool has a clearly distinct purpose: coin flip, random pick from list, dice rolling, D&D stats, repeated rolls, and percentile. No overlap in functionality.
All tool names follow a consistent verb_noun pattern using snake_case: flip_coin, pick_random, roll_dice, roll_dnd_stats, roll_multiple, roll_percentile.
6 tools is appropriate for a dice roller server, covering basic and advanced rolling needs without being excessive or insufficient.
The tool set covers standard dice rolling, percentile, D&D stat generation, repeated rolls, coin flips, and random selection. No obvious gaps for its domain.
MCP server for tabletopsimulator documentation, generated by doc2mcp.
An MCP server that integrates with Discord to provide AI-powered features.
Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.
An MCP server for deep research or task groups