Skip to main content
Glama
patissierMongs

Dice MCP Server

Dice MCP Server

A Model Context Protocol (MCP) server for TRPG dice rolling across multiple game systems.

Quick Start

{
  "mcpServers": {
    "dice": {
      "command": "uvx",
      "args": ["roleplaying-dice-mcp"]
    }
  }
}

Config: macOS ~/Library/Application Support/Claude/claude_desktop_config.json / Windows %APPDATA%\Claude\claude_desktop_config.json

pip / Docker

pip install roleplaying-dice-mcp
roleplaying-dice-mcp
docker build -t dice-mcp-server . && docker run -i dice-mcp-server

Related MCP server: Dice Roller MCP Server

Tools

Tool

Purpose

Key Params

roll_dice

Roll dice using standard notation (NdM+X, kh/kl, dF)

notation, advantage, bonus_dice, target, degrees

roll_pool

Dice pool with success counting (WoD, Shadowrun)

pool, target, explode, count_ones

reroll

Re-roll last roll with same params

get_history

Retrieve recent roll log

limit

clear_history

Clear roll history

See CONTEXT.md for system-specific parameter mappings and invariants.


Parameter Reference

roll_dice

Parameter

Type

Default

Description

notation

string

required

Dice expression: 1d20+5, 4d6kh3, 4dF+2, 1d100

advantage

bool

false

Roll d20 twice, take higher (1d20 only)

disadvantage

bool

false

Roll d20 twice, take lower (1d20 only)

bonus_dice

int

0

CoC bonus dice (0–2, 1d100 only) — extra tens, keep lowest

penalty_dice

int

0

CoC penalty dice (0–2, 1d100 only) — extra tens, keep highest

target

int

DC/AC/skill value for success check

target_mode

enum

"at_least"

"at_least" (D&D: ≥) or "at_most" (CoC: ≤)

critical

bool

false

Nat 20/1 detection. With degrees="pf2e", shifts degree ±1 step

degrees

enum

"coc" / "pf2e" / "pbta" — enables degree calculation

roll_pool

Parameter

Type

Default

Description

pool

int

required

Number of dice (1–50)

sides

int

10

Sides per die

target

int

8

Minimum value for a success (≥)

explode

bool

false

Reroll on max value

double_on

int

Double success at this value or higher (must be ≥ target)

count_ones

bool

false

Enable botch/glitch detection

get_history

Parameter

Type

Default

Description

limit

int

10

Number of recent rolls to retrieve (1–100)

System Coverage

System

Coverage

Key Features Used

D&D 5e

95%

notation, advantage, critical, target, 4d6kh3

CoC 7e

85%

d100, bonus/penalty dice, degrees=coc, at_most

PF2e

85%

d20+mod, degrees=pf2e, critical (nat 20/1 shift)

PbtA

90%

2d6+mod, degrees=pbta

FATE

95%

4dF+mod

WoD

90%

roll_pool, explode, count_ones (botch)

Shadowrun

85%

roll_pool (d6), count_ones (glitch)

Savage Worlds

50%

Exploding works, but no wild die or raise counting

Project Structure

├── server.py              # MCP server — tools & handlers
├── dice_parser.py         # Notation parser (NdM, NdF, kh/kl)
├── history.py             # Roll history manager
├── src/roleplaying_dice_mcp/  # PyPI package
├── tests/test_trpg_scenario.py
├── pyproject.toml
├── Dockerfile
└── README.md

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 5 tool updatesv4.0.0
    • First observedclear_history
    • First observedget_history
    • First observedreroll
    • First observedroll_dice
    • First observedroll_pool

TDQS

A3.8/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose: clear_history manages session history, get_history retrieves it, reroll repeats the last roll, roll_dice handles standard dice notation, and roll_pool focuses on pool-based systems. There is no overlap or ambiguity between these functions.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with clear, descriptive verbs (clear, get, reroll, roll) and specific nouns (history, dice, pool). The naming is uniform and predictable across all five tools.

Tool Count5/5

With 5 tools, this server is well-scoped for dice rolling and session management. Each tool serves a distinct and necessary function, covering core operations without bloat or redundancy.

Completeness5/5

The toolset provides complete coverage for dice rolling domains: session history management (clear and get), roll repetition (reroll), standard dice mechanics (roll_dice), and pool-based systems (roll_pool). There are no obvious gaps for typical TRPG or dice-based workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables dice rolling mechanics for tabletop RPGs including standard dice notation, coin flips, advantage/disadvantage rolls, exploding dice, and maintains a history of recent rolls. Supports D\&D 5e mechanics and various gaming dice types (d4, d6, d8, d10, d12, d20, d100).
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides comprehensive dice rolling functionality for tabletop games and RPGs, supporting standard dice notation, D\&D ability score generation, advantage/disadvantage rolls, and skill checks against difficulty classes.
    -
  • A
    license
    A
    quality
    C
    maintenance
    An MCP server that provides tools for rolling dice using standard notation, flipping coins, and selecting random items from lists. It supports advanced tabletop gaming features such as character stat generation and keep-highest/lowest mechanics.
    6
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables dice rolling for RPG games using standard dice notation, supporting complex expressions like keep/drop, reroll, exploding dice, and batch rolls.
    4
    3
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/patissierMongs/roleplayingMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server