enact-dice-roll-rust

name	enact-dice-roll-rust
version	1.0.0
description	Roll dice with configurable sides and count - a simple Rust example tool
enact	2.0
from	rust:1.75-slim
build	["rustc -o /workspace/dice /workspace/dice.rs"]
command	/workspace/dice ${sides} ${count}
timeout	60s
license	MIT
tags	["dice","random","rust","example","games"]
inputSchema	{"type":"object","properties":{"sides":{"type":"integer","description":"Number of sides on each die (e.g., 6 for a standard die, 20 for a d20)","default":6,"minimum":2,"maximum":100},"count":{"type":"integer","description":"Number of dice to roll","default":1,"minimum":1,"maximum":100}}}
outputSchema	{"type":"object","properties":{"rolls":{"type":"array","items":{"type":"integer"},"description":"Array of individual roll results"},"total":{"type":"integer","description":"Sum of all dice rolls"},"sides":{"type":"integer","description":"Number of sides on each die"},"count":{"type":"integer","description":"Number of dice rolled"}}}
examples	[{"input":{"sides":6,"count":2},"description":"Roll two standard 6-sided dice"},{"input":{"sides":20,"count":1},"description":"Roll a single d20 (classic tabletop gaming)"},{"input":{"sides":6,"count":4},"description":"Roll 4d6 (common for D&D character stats)"}]

Dice Roll (Rust)

A simple dice rolling tool written in Rust. Demonstrates how to create an Enact tool with Rust.

Features

• Roll any number of dice with configurable sides
• Returns individual rolls and total sum
• Supports common dice types: d4, d6, d8, d10, d12, d20, d100

Usage Examples

CLI

Roll a single d6

enact run enact/dice-roll-rust

Roll 2d6 (two six-sided dice)

enact run enact/dice-roll-rust -a '{"sides": 6, "count": 2}'

Roll a d20

enact run enact/dice-roll-rust -a '{"sides": 20}'

Roll 4d6 for D&D stats

enact run enact/dice-roll-rust -a '{"sides": 6, "count": 4}'

MCP (for LLMs/Agents)

When using via MCP, call enact__dice-roll-rust with:

• sides: Number of sides per die (default: 6)
• count: Number of dice to roll (default: 1)

Output

Returns JSON with:

• rolls: Array of individual die results
• total: Sum of all rolls
• sides: The die type used
• count: Number of dice rolled