# D20DAO Verifiable Randomness

> D20DAO Verifiable Randomness is a paid MCP server for finance and payments. Verifiable random draws for agents: dice, coin flips, shuffles, paid 0.05 USDC each. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://d20dao.org/docs/agents
- **Repository:** https://github.com/d20dao/mcp
- **MCP Registry name:** org.d20dao/vrf
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-15

## About

This npm package runs locally over stdio and lets an agent request randomness that can be checked afterwards. Each draw is a VRF request on Arc whose request and fulfilment transactions come back with the result, so anyone can replay the proof. An optional seed of up to 64 bytes is bound on chain, which suits raffles that must name their round before the result exists.

Payment goes through the Circle CLI from the user's own Circle Agent Wallet. The server holds no keys, pays only api.d20dao.org, never more than 0.05 USDC per draw, and keeps to a daily cap that defaults to 1 USDC. A repeat of an identical draw within five minutes returns the earlier one without paying again.

A draw usually answers in about ten seconds, so clients with a 60-second tool timeout may want a higher setting. The same service is also an x402 HTTP API, and on Robinhood Chain contracts integrate through the SDK instead.

## Features

- **Seven draw types:** Raw word, coin flip, dice, range, choose one, choose many and shuffle.
- **On-chain proof:** Results come with request and fulfilment transactions.
- **Spending cap:** Daily limit in USDC, shared across server processes.
- **Seeded draws:** Bind a seed on chain before the result exists.
- **No key custody:** The Circle CLI signs; the server never holds keys.
- **Free lookups:** Read a past draw or check setup at no cost.

## Good for

- Run a verifiable raffle
- Pick winners from a list with a proof
- Roll dice in an agent-run game
- Shuffle items so the order can be audited

## Install

### Claude Code (Terminal)

```sh
claude mcp add vrf -- npx -y @d20dao/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vrf": {
      "command": "npx",
      "args": [
        "-y",
        "@d20dao/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vrf": {
      "command": "npx",
      "args": [
        "-y",
        "@d20dao/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vrf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@d20dao/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vrf": {
      "command": "npx",
      "args": [
        "-y",
        "@d20dao/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vrf": {
      "command": "npx",
      "args": [
        "-y",
        "@d20dao/mcp"
      ]
    }
  }
}
```

## Tools

- `draw`: Paid draw (0.05 USDC): raw, coinFlip, dice, range, chooseOne, chooseMany or shuffle, returned with proof links.
- `get_result`: Free: reads a draw by paymentId or a request by requestId.
- `setup_status`: Free: checks the CLI, login, wallet, Gateway balance and today's spending.

## FAQ

### What does a draw cost?

0.05 USDC.

### Which chain does it run on?

Arc; Robinhood Chain uses direct on-chain integration through the SDK.

### Is a retry charged twice?

No. A retry after a timeout returns the same draw.

### What do I need first?

A funded Circle Agent Wallet with a Gateway USDC balance.

### Is D20DAO Verifiable Randomness free?

No. D20DAO Verifiable Randomness is a paid product.

### How do I add D20DAO Verifiable Randomness to Claude Code?

Run this command in your terminal: claude mcp add vrf -- npx -y @d20dao/mcp

### What are the best alternatives to D20DAO Verifiable Randomness?

The closest alternatives to D20DAO Verifiable Randomness are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/d20dao-verifiable-randomness
