MCP Marketplace
Sign inSign up
Back to Browse

Vrf MCP Server

by D20dao
Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Verifiable dice, draws and shuffles with on-chain VRF proofs on Arc. 0.05 USDC per draw.

About

Verifiable dice, draws and shuffles with on-chain VRF proofs on Arc. 0.05 USDC per draw.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

4 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Spending cap per UTC day in USDC (default 1; 0 turns paid draws off).Optional

Environment variable: D20_DAILY_LIMIT_USDC

mainnet (default) or testnet.Optional

Environment variable: D20_NETWORK

Circle CLI chain code to pay from, such as ARC or BASE (default: first funded).Optional

Environment variable: D20_PAY_CHAIN

Agent wallet to pay from (default: the first one the Circle CLI lists).Optional

Environment variable: D20_WALLET_ADDRESS

Path to the Circle CLI's dist/index.js (default: circle on PATH).Optional

Environment variable: D20_CIRCLE_CLI

Folder for the daily spending record (default ~/.d20dao-mcp).Optional

Environment variable: D20_MCP_HOME

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "org-d20dao-vrf": {
      "env": {
        "D20_NETWORK": "your-d20-network-here",
        "D20_MCP_HOME": "your-d20-mcp-home-here",
        "D20_PAY_CHAIN": "your-d20-pay-chain-here",
        "D20_CIRCLE_CLI": "your-d20-circle-cli-here",
        "D20_WALLET_ADDRESS": "your-d20-wallet-address-here",
        "D20_DAILY_LIMIT_USDC": "your-d20-daily-limit-usdc-here"
      },
      "args": [
        "-y",
        "@d20dao/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

D20DAO MCP server

Verifiable randomness for AI agents: dice, coin flips, ranges, winners and shuffles, each one a VRF request on Arc with a proof anyone can replay. 0.05 USDC per draw, paid from your Circle Agent Wallet.

Setup

  1. Wallet. Have your agent follow Circle's setup guide. It installs the Circle CLI, logs you in with an emailed code and creates an agent wallet. You accept Circle's terms yourself.

  2. Funds. Fund the wallet with USDC and deposit some into Circle Gateway, for example on Arc:

    circle gateway deposit --chain ARC --method direct --amount 1 --address <wallet>

    Arc, Polygon, Avalanche, Base, Arbitrum, Optimism, Unichain and Ethereum balances all work.

  3. Server. Add it to your client.

    Claude Code:

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

    Claude Desktop, Cursor and others (mcpServers in the client's MCP config):

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

    On Windows, use "command": "cmd" with "args": ["/c", "npx", "-y", "@d20dao/mcp@0.1.0"] if the client cannot start npx directly. Pin the version, since the server runs with your Circle session.

Ask your agent to call setup_status; it names the next step until everything is ready.

Tools

ToolCostDoes
draw0.05 USDCraw, coinFlip, dice (up to 128), range, chooseOne, chooseMany, shuffle (up to 256 items). Returns the result with request, fulfillment and proof links.
get_resultfreeReads a draw by paymentId or a request by requestId.
setup_statusfreeChecks the CLI, login, wallet, Gateway balance and today's spending.

An optional seed (up to 64 bytes) is bound on chain to the draw, so a raffle can name its round before the result exists. Give each separate draw its own seed: an identical draw within five minutes returns the earlier one without paying.

A draw usually answers in about ten seconds, but it can take longer. If your client's tool timeout is short (60 seconds is a common default), raise it; a retry after a timeout returns the same draw rather than paying twice.

Settings

VariableDefault
D20_DAILY_LIMIT_USDC1Spending cap per UTC day, shared by every server process of the user. 0 turns paid draws off.
D20_NETWORKmainnettestnet uses the Arc Testnet API and a testnet CLI login (circle wallet login <email> --testnet).
D20_PAY_CHAINfirst fundedCircle CLI chain code to pay from, such as ARC or BASE.
D20_WALLET_ADDRESSfirst agent walletAgent wallet to pay from.
D20_CIRCLE_CLIcircle on PATHPath to the CLI's dist/index.js.
D20_MCP_HOME~/.d20dao-mcpWhere the spending record is kept.

Safety

  • The server holds no keys. The Circle CLI signs, and your Circle wallet limits apply. It never accepts Circle's terms for you: CIRCLE_ACCEPT_TERMS is kept out of the CLI it runs, and DO_NOT_TRACK is set so your item labels stay out of the CLI's telemetry.
  • It pays only api.d20dao.org (or api-testnet.d20dao.org) and never more than 0.05 USDC per draw. If the CLI ever reports another seller, that draw comes back with a warning and paid draws stop until you delete halt.json from the server's home folder.
  • Each draw reserves its price in the daily record before paying; if the record cannot be written, it does not pay.
  • A draw that is still pending is finished for free with get_result. If the answer is lost after payment, the server resends the payment the CLI signed, which the API honours at most once.
  • A result says charged: false only when that is known. When it says unknown, do not draw again; check with get_result or the wallet.
  • draw is marked as a tool with side effects, so clients ask before running it unless you allow it.

Verify

Every result links its request and fulfillment transactions and a proof page. Replay the proof yourself with @d20dao/vrf-sdk; see verification and the agent API guide.

License

MIT

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

90.6K
Stars
18
Installs
6.5
Security
No ratings yet
Local

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

90.6K
Stars
18
Installs
5.3
Security
5.0
Local

Paperclip

Free

by Paperclipai · Developer Tools

Trending hip-hop artist momentum scores across four cultural dimensions.

81.1K
Stars
1
Installs
10.0
Security
No ratings yet
Remote

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

223
Stars
782
Installs
8.0
Security
4.8
Local

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

-
Stars
137
Installs
10.0
Security
4.7
Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

-
Stars
118
Installs
10.0
Security
5.0
Remote