Skip to content
MCP server

D20DAO Verifiable Randomness

Verifiable random draws for agents: dice, coin flips, shuffles, paid 0.05 USDC each

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
CLI, API
Runs
Locally
Version
0.1.2
Listing updated
2 days ago

About D20DAO Verifiable Randomness

D20DAO Verifiable Randomness is a paid MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vrf": {
      "command": "npx",
      "args": [
        "-y",
        "@d20dao/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vrf": {
      "command": "npx",
      "args": [
        "-y",
        "@d20dao/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • D20_DAILY_LIMIT_USDCSpending cap per UTC day in USDC (default 1; 0 turns paid draws off).
  • D20_NETWORKArc Mainnet (default) or Arc Testnet.
  • D20_PAY_CHAINCircle CLI chain code to pay from, such as ARC or BASE (default: first funded).
  • D20_WALLET_ADDRESSAgent wallet to pay from (default: the first one the Circle CLI lists).
  • D20_CIRCLE_CLIPath to the Circle CLI's dist/index.js (default: circle on PATH).
  • D20_MCP_HOMEFolder for the daily spending record (default ~/.d20dao-mcp).

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Paid

0.05 USDC per paid draw; reading results and setup checks are free

Prices change. Check d20dao.org before you buy.

D20DAO Verifiable Randomness 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 to D20DAO Verifiable Randomness

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools