MCP Server

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

Name: Dungeon Roll — On-Chain D&D Combat MCP Server
Author: io.github.dungeonroll0

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)

Claude Desktop

~/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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_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>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "dungeon-roll": {
      "type": "stdio",
      "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>"
      }
    }
  }
}

Claude Code

claude mcp add dungeon-roll --env RPC_URL=<YOUR_RPC_URL> --env PRIVATE_KEY=<YOUR_PRIVATE_KEY> --env ENGINE_URL=<YOUR_ENGINE_URL> --env REGISTRY_ADDRESS=<YOUR_REGISTRY_ADDRESS> --env ESCROW_ADDRESS=<YOUR_ESCROW_ADDRESS> -- npx -y dungeon-roll-mcp