Server Dice Roll

An MCP server that parses dice notation and rolls dice, supporting standard and Fate dice for interactive gaming and simulations.

typescript

2

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "lpbayliss-server-dice-roll": {
      "command": "npx",
      "args": [
        "-y",
        "server-dice-roll"
      ]
    }
  }
}

This MCP server lets you parse dice notation and perform dice rolls, including standard dice and Fate/Fudge dice. It’s useful for tabletop games, simulations, or any scenario where you want reliable, programmatic dice results within an MCP client.

How to use

You can integrate this server with an MCP client to parse notation like 3d6+4 or 4dF and then roll the dice to get a detailed breakdown of each die and the total. Use the two primary tools: one to parse a notation string and another to perform the actual roll. You’ll receive structured results you can display in your app or game UI.

How to install

Prerequisites: you should have Node.js and npm installed on your system. You can check with node -v and npm -v.

Install the MCP server globally or run it directly via npx. Use one of the following options.

# Install globally
npm install -g server-dice-roll

# Run the server
mcp-server-dice-roll

# Or run directly with npx
npx server-dice-roll

Claude Desktop configuration

If you use Claude Desktop, add this MCP server to your configuration so Claude can communicate with it.

{
  "mcpServers": {
    "dice": {
      "command": "npx",
      "args": ["-y", "server-dice-roll"]
    }
  }
}

Available tools

parse_dice_roll_notation

Parses a dice notation string and returns a structured representation with type, count, sides, and modifier.

dice_roll

Rolls dice based on a configuration and returns the list of individual rolls, the total, and the original notation.