🎲 Advanced Dice Rolling MCP Server

TypeScript-based MCP server for AI assistants

A comprehensive TypeScript-based Model Context Protocol (MCP) server that provides advanced dice rolling capabilities for AI assistants. Perfect for tabletop gaming, RPGs, and any application requiring sophisticated random number generation with gaming mechanics.

🚀 Remote MCP Configuration

MCP Integration URL - Compatible with Claude and ChatGPT Connectors

Use this endpoint for remote MCP connections:

https://dice-rolling-mcp.vercel.app/mcp

Configure in Claude Desktop:

{
  "mcpServers": {
    "dice-rolling-remote": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/client-stdio", 
        "connect", 
        "https://dice-rolling-mcp.vercel.app/mcp"
      ]
    }
  }
}

🛠️ Available Tools & Features

🎲 dice_roll

Roll dice using standard notation with full gaming support

  • Basic notation: 1d20+5
  • Advantage/Disadvantage: 2d20kh1
  • Exploding dice: 3d6!
  • Rerolls: 4d6r1
  • Success counting: 5d10>7

✅ dice_validate

Validate and explain dice notation without rolling

  • Parse complex notation
  • Explain mechanics
  • Catch syntax errors
  • Educational breakdowns
⚠️ Important: For D&D 5e advantage, always use 2d20kh1 (NOT 2d20). The latter adds both dice together (2-40 range) instead of keeping the higher roll (1-20 range).

📋 Quick Reference

Most Common Patterns

Basic Rolls

  • 1d20 - Single d20
  • 3d6 - Three d6
  • 1d8+3 - d8 plus modifier

D&D 5e Essential

  • 2d20kh1 - Advantage (NOT 2d20)
  • 2d20kl1 - Disadvantage
  • 4d6kh3 - Stat generation

Special Mechanics

  • 3d6! - Exploding 6s
  • 4d6r1 - Reroll 1s
  • 5d10>7 - Count 7+ as successes

📖 Complete Dice Notation Guide

Advantage and Disadvantage

⚠️ IMPORTANT: For D&D 5e advantage/disadvantage, use these formats:
  • 2d20kh1 - Advantage (roll 2d20, keep highest 1)
  • 2d20kl1 - Disadvantage (roll 2d20, keep lowest 1)

Wrong: 2d20 (adds both dice = 2-40 range)
Correct: 2d20kh1 (keeps higher die = 1-20 range)

Keep and Drop Mechanics

  • 4d6kh3 - Keep highest 3 of 4d6
  • 4d6kl3 - Keep lowest 3 of 4d6
  • 4d6dh1 - Drop highest 1 (= kl3)
  • 4d6dl1 - Drop lowest 1 (= kh3)

Special Dice

  • 4dF - Fudge dice (-1, 0, +1)
  • 1d% - Percentile die (1-100)
  • 1d2 - Coin flip

Gaming Examples

  • 2d20kh1+7 - Advantage attack +7
  • 8d6 - Fireball damage
  • 1d20+1d4+3 - Check with guidance