mcp-dice: A MCP Server for Rolling Dice

What is mcp-dice?

A Model Context Protocol (MCP) server that enables Large Language Models (LLMs) to roll dice. It accepts standard dice notation (e.g., 1d20) and returns both individual rolls and their sum.

How to use mcp-dice?

Install via Smithery with npx @smithery/cli install mcp-dice --client claude or run directly with uvx mcp-dice. The server expects a JSON object with a notation field (e.g., {"notation": "2d6+3"}). For Claude Desktop, add a configuration entry with command uvx and args ["mcp-dice"] in claude_desktop_config.json.

Key features of mcp-dice

• Supports standard dice notation (e.g., 1d20, 3d6)
• Returns individual rolls and total sum
• Handles modifiers (e.g., 2d8+1)
• Easy integration with Claude Desktop
• Compatible with MCP Inspector for debugging

Use cases of mcp-dice

—

FAQ from mcp-dice

How do I install mcp-dice?

Install via Smithery using npx @smithery/cli install mcp-dice --client claude, or run directly with uvx mcp-dice (requires uv to be available).

What dice notation does mcp-dice support?

It supports standard dice notation such as 1d20, 3d6, and 2d8+1.

How do I configure mcp-dice with Claude Desktop?

Add an entry to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%/Claude/) with command uvx and args ["mcp-dice"].

What is the output format?

Returns a JSON object containing rolls (array), sum, modifier, total, notation, and timestamp.

Can I use mcp-dice for debugging?

Yes, it is compatible with MCP Inspector. Run npx @modelcontextprotocol/inspector uvx mcp-dice to inspect and debug the server.