dice-roll
Verifiable dice roll from a seed, with a re-derivable transcript — Rolls dice notation (for example 4d6kh3+2) from a caller seed with a documented SHA-256 counter-mode stream and returns every die, the kept/dropped marks and a full draw transcript, for agents and referees that need a roll anyone can re-derive. Optionally checks a claimed total or claimed faces against the re-derived roll. Does NOT provide unpredictable randomness: the seed is public input, so any
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"notation": "<notation>",
"seed": "<seed>"
},
"name": "dice-roll"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | Yes | Caller seed string. Public: the outcome is a pure function of notation and seed. | |
| notation | Yes | Dice notation: terms of NdM (N 1-100, M 2-1000) or integers joined by + and -; optional kh/kl/dh/dl with a count on a group. At most 20 groups and 1000 dice. | |
| expectRolls | No | Optional claimed faces in notation order, before keep/drop marks. | |
| expectTotal | No | Optional claimed total to verify. | |
| includeTranscript | No | Default true. False drops blocks and draws (the transcript digest stays). |