# 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

```bash
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`:

```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