mcp-randoom

mcp-randoom

A Model Context Protocol (MCP) server that provides true random generation tools for your AI agents. Whether you need an AI to make a decision for you, or you want it to act as a Dungeon Master for your next D&D session, mcp-randoom has you covered.

Features

• Coin Flip: Let the AI decide your fate with a secure 50/50 coin toss. Perfect for "Heads or Tails" scenarios.
• Dice Roller: A robust dice roller supporting standard D&D notation (e.g., 1d20, 2d6, 4d8). Great for TTRPG sessions where the AI plays the DM or a player.
• True Random Numbers: Generate cryptographically secure random integers or floating-point numbers within a specified range.
• Wheel of Fortune: Spin a virtual wheel to randomly select an item from a list of options (great for raffles or decision making).

Usage

You can run this MCP server directly using bunx without needing to install it globally.

Quick Start

bunx github:ringotypowriter/mcp-randoom

Using with Claude Desktop

To use this with Claude Desktop, add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "randoom": {
      "command": "bunx",
      "args": [
        "github:ringotypowriter/mcp-randoom"
      ]
    }
  }
}

Tools

coin_flip

Flips a coin and returns "Heads" or "Tails".

dice_roll

Rolls dice based on input notation.

• Input: dice (string) - e.g., "1d20", "2d6".
• Output: Individual rolls and the total sum.

random_number

Generates a random number.

• Input:
• min (number)
• max (number)
• integer (boolean, default: true)
• Output: A random number within the range.

wheel_spin

Spins a wheel to randomly select one option from a list.

• Input: options (array of strings) - List of options (must be > 3).
• Output: The selected option.

License

MIT