English Français العربية

Dungeon Roll — On-Chain D&D Combat

Official registry AI and agents

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

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package dungeon-roll-mcp
Claude Code 
claude mcp add dungeon-roll-on-chain-d-d-combat -e 'RPC_URL=<RPC_URL>' -e 'PRIVATE_KEY=<your private_key>' -e 'ENGINE_URL=<ENGINE_URL>' -e 'REGISTRY_ADDRESS=<REGISTRY_ADDRESS>' -e 'ESCROW_ADDRESS=<ESCROW_ADDRESS>' -- npx -y dungeon-roll-mcp@0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dungeon-roll-on-chain-d-d-combat": {
            "command": "npx",
            "args": [
                "-y",
                "dungeon-roll-mcp@0.2.0"
            ],
            "env": {
                "RPC_URL": "<RPC_URL>",
                "PRIVATE_KEY": "<your private_key>",
                "ENGINE_URL": "<ENGINE_URL>",
                "REGISTRY_ADDRESS": "<REGISTRY_ADDRESS>",
                "ESCROW_ADDRESS": "<ESCROW_ADDRESS>"
            }
        }
    }
}

Environment variables

  • 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)

Frequently asked questions

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

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

How do I install Dungeon Roll — On-Chain D&D Combat?

It runs on your machine. In Claude Code: claude mcp add dungeon-roll-on-chain-d-d-combat -e 'RPC_URL=<RPC_URL>' -e 'PRIVATE_KEY=<your private_key>' -e 'ENGINE_URL=<ENGINE_URL>' -e 'REGISTRY_ADDRESS=<REGISTRY_ADDRESS>' -e 'ESCROW_ADDRESS=<ESCROW_ADDRESS>' -- npx -y dungeon-roll-mcp@0.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Dungeon Roll — On-Chain D&D Combat need an API key?

Yes. It expects PRIVATE_KEY, which you set in its configuration.

Is Dungeon Roll — On-Chain D&D Combat open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Dungeon Roll — On-Chain D&D Combat?

It is published by dungeonroll0. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.