Random Picker

Calculators REST API MCP

Generate random numbers, pick random items from a list, or split people into random teams. Returns the numbers, the picks, or the teams, plus a ready-to-paste text. Uses cryptographic randomness. Mode "number": min/max/count/allow_duplicates. Mode "list": items/pick_count (no repeats). Mode "teams": members/team_count (round-robin after a shuffle).

This page documents the MCP tool findutils:random_picker. See the REST reference →

Call it over MCP

Tool name findutils:random_picker · no API keys · 120 requests/min per IP

Claude Code

claude mcp add findutils --transport http https://mcp.findutils.com/

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}

Raw JSON-RPC (any MCP client) — verified example

curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "random_picker",
      "arguments": {
        "mode": "number",
        "min": 1,
        "max": 100,
        "count": 3
      }
    }
  }'

Input schema

Argument Type Required Description
mode string (number | list | teams) no What to randomise: "number", "list", or "teams". Default "number". Default: "number".
min integer no Number mode: smallest value (inclusive). Default 1. Default: 1.
max integer no Number mode: largest value (inclusive). Default 100. Default: 100.
count integer no Number mode: how many numbers (1-10000). Default 1. Without duplicates, a count above the range returns every number in the range, shuffled. Default: 1.
allow_duplicates boolean no Number mode: allow the same number twice. Default false. Default: false.
items array no List mode: items to pick from (array of strings, or one newline-separated string).
pick_count integer no List mode: how many items to pick without repeats (1-10000). Default 1. Default: 1.
members array no Teams mode: people to split (array of strings, or one newline-separated string).
team_count integer no Teams mode: number of teams (2-20). Default 2. Default: 2.

Example arguments (verified)

{
  "mode": "number",
  "min": 1,
  "max": 100,
  "count": 3
}

Also a REST endpoint

The same tool answers plain HTTP at POST /api/tools/random-picker/execute — no key, 60 requests/min.

Open the REST reference for Random Picker →

More Calculators tools