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 HTTP endpoint POST /api/tools/random-picker/execute. See the MCP reference →

Use in the browser View as Markdown

Call it over REST

POST https://api.findutils.com/api/tools/random-picker/execute · no API keys · 60 requests/min per IP

Execute — verified arguments

curl -X POST https://api.findutils.com/api/tools/random-picker/execute \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "number",
    "min": 1,
    "max": 100,
    "count": 3
  }'

Parameter schema for this endpoint

curl https://api.findutils.com/api/tools/random-picker

Interactive docs · OpenAPI 3.1 spec · All REST tools

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 an MCP tool

Claude, Cursor, and any MCP client can call this tool as findutils:random_picker after one connect command.

Connect once

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

Open the MCP reference for Random Picker →

More Calculators tools

Bmi Calculate

Compute Body Mass Index (BMI) with metric (kg/cm) or imperial (lb/in) units.

Body Fat Calculator

Estimate body fat percentage, fat mass, lean mass, BMI, and a body-composition category.

Carbon Footprint Calculator

Estimate an annual personal carbon footprint in tonnes of CO2 from home energy, transportation, and lifestyle, with a per-category breakdown

Chmod Calculate

Convert between numeric (755) and symbolic (rwxr-xr-x) Unix file permissions.

Cloudflare Cost Calculate

Estimate monthly Cloudflare developer platform costs (Workers, D1, R2, KV, Durable Objects) under free or $5 Workers Paid plans.

Daily Habit Calculator

Calculate how a daily habit adds up over a week, a month (30 days), a year (365 days), or a custom date range: total units, total cost, and

Gcd Calculate

Greatest Common Divisor (GCD) and Least Common Multiple (LCM) of two non-negative integers.

Llm Requirements Calculator

Estimate the VRAM, system RAM, and disk space needed to run an open-weight LLM locally, and which common GPUs and Macs it fits on.