Dice

You can run an MCP server that lets Large Language Models roll dice using standard notation (like 1d20 or 3d6+2). It returns both the individual rolls and the total, making it easy to integrate dice-rolling into conversations and automated workflows.

How to use

You interact with the server through an MCP client. Start the server via your preferred MCP client setup, then send a request with a dice notation such as 2d6+3. The server responds with the individual rolls, the sum of those rolls, any modifiers, and the final total, along with the notation and a timestamp.

How to install

Prerequisites you need before installing the MCP server:
- A working development environment with Git installed
- The MCP runner you plan to use (for example uvx) installed on your system
- Python and the uvx tooling, if you plan to run development tasks locally

Step 1: Install the MCP runner (uvx) on your system according to your platform. This enables you to start and manage MCP servers locally.

Step 2: Install development dependencies for the server.

• Clone the repository
• Install dev dependencies using the MCP development workflow

Step 3: Run the server using the MCP command configured for your environment.

• For a standard run with the MCP Dice server, use the MCP runner to start the server with the dice command.

Configuration and usage notes

Claude Desktop integration allows you to connect the MCP server to Claude Desktop by configuring an MCP server entry that starts the server via a simple command. Example configurations show how to run the server through the MCP runner and how to adapt the path for local development.

Additional configuration examples

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

Development and debugging

If you are developing or debugging, you can use a development CLI command to run the server locally. The following example shows starting the MCP-Dice server from a local repo path using uvx in development mode.

Claude Desktop configuration for development

{
  "mcpServers": {
    "dice": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "path/to/mcp-dice-repo",
        "mcp-dice"
      ]
    }
  }
}

Windows and WSL configuration

For Windows using WSL, you can start the server with a shell that runs the MCP-Dice command inside WSL. The example runs uvx mcp-dice from within WSL.

{
  "mcpServers": {
    "dice": {
      "command": "wsl",
      "args": [
        "-e",
        "zsh",
        "-lc",
        "uvx mcp-dice"
      ]
    }
  }
}

Usage notes for input and responses

The server expects a request specifying the dice notation, such as 2d6+3. It responds with the individual roll values, the sum of those rolls, any modifier, the total, and the original notation along with a timestamp.

Available tools

rollDice

Parses standard dice notation (e.g., 2d6, 1d20+3) and executes each die roll.

parseNotation

Interprets the notation to determine the number of dice, types, and modifiers.

computeTotal

Calculates the sum of all individual dice rolls and any modifiers to produce the final total.

formatResponse

Assembles the response containing individual rolls, the sum, the total, the notation used, and a timestamp.