{
  "markdown": "# MCP Dice Roller 🎲\n\nA simple MCP (Model Context Protocol) server for rolling dice. Perfect for tabletop games, random decisions, and more!\n\n<!-- mcp-name: io.github.vandewilly/dice-roller -->\n\n## Features\n\n- **Standard Dice Notation** - Roll any dice using notation like `2d6`, `1d20+5`, `3d8-2`\n- **Keep Highest/Lowest** - Support for `4d6kh3` (keep highest 3) and `2d20kl1` (keep lowest)\n- **D&D Stat Rolling** - Quick character stat generation using 4d6 drop lowest\n- **Coin Flips** - Simple heads or tails\n- **Random Picker** - Choose randomly from a list of options\n- **Percentile Dice** - Roll d100 with tens and ones dice\n\n## Installation\n\n```bash\npip install mcp-dice-roller\n```\n\n## Usage\n\n### With Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"dice-roller\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"mcp_dice_roller\"]\n    }\n  }\n}\n```\n\n### With VS Code\n\nAdd to your VS Code MCP settings:\n\n```json\n{\n  \"mcp.servers\": {\n    \"dice-roller\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"mcp_dice_roller\"]\n    }\n  }\n}\n```\n\n## Tools\n\n### roll_dice\n\nRoll dice using standard notation.\n\n```\nroll_dice(\"2d6\")       → Roll two 6-sided dice\nroll_dice(\"1d20+5\")    → Roll d20 and add 5\nroll_dice(\"4d6kh3\")    → Roll 4d6, keep highest 3\nroll_dice(\"2d20kl1\")   → Roll 2d20, keep lowest (disadvantage)\n```\n\n**Example Response:**\n```json\n{\n  \"notation\": \"2d6+3\",\n  \"rolls\": [4, 6],\n  \"kept\": [4, 6],\n  \"subtotal\": 10,\n  \"modifier\": 3,\n  \"total\": 13\n}\n```\n\n### roll_multiple\n\nRoll the same dice multiple times with statistics.\n\n```\nroll_multiple(\"1d20\", 5)  → Roll d20 five times\n```\n\n**Example Response:**\n```json\n{\n  \"notation\": \"1d20\",\n  \"times\": 5,\n  \"totals\": [15, 8, 20, 3, 12],\n  \"statistics\": {\n    \"min\": 3,\n    \"max\": 20,\n    \"sum\": 58,\n    \"average\": 11.6\n  }\n}\n```\n\n### roll_dnd_stats\n\nGenerate D&D 5e character ability scores.\n\n**Example Response:**\n```json\n{\n  \"method\": \"4d6 drop lowest\",\n  \"stats\": [\n    {\"rolls\": [4, 3, 5, 6], \"kept\": [4, 5, 6], \"total\": 15},\n    {\"rolls\": [2, 4, 4, 3], \"kept\": [3, 4, 4], \"total\": 11},\n    ...\n  ],\n  \"totals\": [15, 11, 14, 13, 10, 16],\n  \"sum\": 79\n}\n```\n\n### flip_coin\n\nFlip a coin.\n\n```\nflip_coin()      → Flip once\nflip_coin(10)    → Flip 10 times\n```\n\n### pick_random\n\nPick randomly from options.\n\n```\npick_random(\"pizza, burger, sushi, tacos\")\n```\n\n**Example Response:**\n```json\n{\n  \"options\": [\"pizza\", \"burger\", \"sushi\", \"tacos\"],\n  \"selected\": \"sushi\",\n  \"total_options\": 4\n}\n```\n\n### roll_percentile\n\nRoll d100 (percentile dice).\n\n**Example Response:**\n```json\n{\n  \"tens_die\": 7,\n  \"ones_die\": 3,\n  \"result\": 73\n}\n```\n\n## Development\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/vandewilly/mcp-dice-roller.git\ncd mcp-dice-roller\n\n# Install dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest\n```\n\n### Running Locally\n\n```bash\npython -m mcp_dice_roller\n```\n\n## MCP Registry\n\n**MCP Name:** `io.github.vandewilly/dice-roller`\n\nThis server is published to the [MCP Registry](https://registry.modelcontextprotocol.io/).\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Author\n\nVandewilly Silva ([@vandewilly](https://github.com/vandewilly))\n",
  "bytes": 3278,
  "sha": "b862983c4d6a0e6cc2b11bd358cc5570768f1206aed111ff100b8cf61759a397",
  "repo_slug": "vandewilly/mcp-dice-roller",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_vandewilly_dice_roller_457a0a0a/readme"
}