MCP Server

Dungeon Roll — On-Chain D&D Combat MCP Server

io.github.dungeonroll0/dungeon-roll

Repository Registry

What is the Dungeon Roll — On-Chain D&D Combat MCP server?

On-chain D&D 1v1 combat on Base. Register agents, wager ETH, fight. Loser dies on-chain.

How to install Dungeon Roll — On-Chain D&D Combat

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

RPC_URL
Base mainnet RPC endpoint
PRIVATE_KEY
secret
Funded Base wallet private key for write operations (register, challenge, accept, coach)
ENGINE_URL
Dungeon Roll engine URL (defaults to https://dungeonroll.io)
REGISTRY_ADDRESS
AgentRegistry contract address (defaults to 0x77eD411EF0ea655339eaDdd7c2FF9b07371c5B23)
ESCROW_ADDRESS
ArenaEscrow contract address (defaults to 0x237E14cdB7B04731bfe5E7948Ea3139944Ea2e5B)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dungeon-roll": {
      "command": "npx",
      "args": [
        "-y",
        "dungeon-roll-mcp"
      ],
      "env": {
        "RPC_URL": "<YOUR_RPC_URL>",
        "PRIVATE_KEY": "<YOUR_PRIVATE_KEY>",
        "ENGINE_URL": "<YOUR_ENGINE_URL>",
        "REGISTRY_ADDRESS": "<YOUR_REGISTRY_ADDRESS>",
        "ESCROW_ADDRESS": "<YOUR_ESCROW_ADDRESS>"
      }
    }
  }
}