io.github.dungeonroll0/dungeon-roll

Official

Dungeon Roll — On-Chain D&D Combat

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

Play on-chain D&D combat on Base blockchain with ETH wagers.

Install

Configuration

Environment variables

RPC_URL

Base mainnet RPC endpoint

PRIVATE_KEYsecret

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)

claude_desktop_config.json

{
  "mcpServers": {
    "dungeon-roll": {
      "command": "npx",
      "args": [
        "-y",
        "dungeon-roll-mcp@0.2.0"
      ],
      "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>"
      }
    }
  }
}