io.github.CloudCorpRecords/diceport
Dice rolls, coin flips, and random numbers, reproducible with a seed.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@reneturcios/diceportclaude mcp add diceport -- npx -y @reneturcios/diceport@0.1.0 mcp{
"mcpServers": {
"diceport": {
"command": "npx",
"args": [
"-y",
"@reneturcios/diceport@0.1.0",
"mcp"
]
}
}
}ghcr.io/cloudcorprecords/diceport:0.1.0claude mcp add diceport -- docker run -i --rm ghcr.io/cloudcorprecords/diceport:0.1.0 mcp{
"mcpServers": {
"diceport": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/cloudcorprecords/diceport:0.1.0",
"mcp"
]
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
diceport
diceport rolls dice, flips coins, and picks random integers. It is built for the moments when a script or an agent needs a fair, explainable bit of chance: a roll reports every face that went into its total, and any call can take a seed that makes the outcome reproducible — same seed, same result, every time.
Install
npx @reneturcios/diceport roll 2d6Or run the container image:
docker run -i ghcr.io/cloudcorprecords/diceportThe container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.
CLI
# Roll dice in NdM notation, with an optional +N / -N modifier
diceport roll 2d6
# 2d6: [3, 5] total 8
diceport roll 3d8+2 --seed 42 # reproducible
# Flip a coin
diceport flip # heads (or tails)
diceport flip --seed 7 --json
# Pick an integer between two bounds, inclusive
diceport random 1 100
diceport random 1 100 --seed 42
diceport --versionNotation is NdM: roll N dice with M sides each. The count may be
left off (d20 rolls one die) and a flat modifier may be appended
(2d6+3, 1d100-5).
Exit codes: 0 on success, 1 when a roll or range cannot be done
(bad notation, an inverted range — the error says why), 2 for usage
errors.
MCP server
One bin serves both faces. The mcp subcommand starts a stdio MCP
server:
npx -y @reneturcios/diceport mcpMCP client configuration:
{
"mcpServers": {
"diceport": {
"command": "npx",
"args": ["-y", "@reneturcios/diceport", "mcp"]
}
}
}Tools
| Tool | Input | What it returns |
|---|---|---|
roll_dice | notation (string, required, e.g. 2d6+3), seed (integer, optional) | Every individual face rolled, the modifier, and the total. |
flip_coin | seed (integer, optional) | heads or tails. |
random_number | min, max (integers, required), seed (integer, optional) | One integer between min and max, inclusive. |
Seeded calls use a mulberry32 generator, so a seed fully determines the outcome and any reported result can be replayed. Unseeded calls draw from the platform random source.
Development
npm install
npm run build # tsc -> dist/
npm test # node test runner over test/*.test.ts, no network
npm run dev # run the CLI from source via tsxLicense
MIT — see LICENSE.
Frequently asked questions
What is io.github.CloudCorpRecords/diceport?
Dice rolls, coin flips, and random numbers, reproducible with a seed.
How do I install io.github.CloudCorpRecords/diceport?
It runs on your machine. In Claude Code: claude mcp add diceport -- npx -y @reneturcios/diceport@0.1.0 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.CloudCorpRecords/diceport need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.CloudCorpRecords/diceport open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.CloudCorpRecords/diceport?
It is published by CloudCorpRecords. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.