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

Ass To Srt

Flatten an Advanced SubStation Alpha (.ass) or SubStation Alpha (.ssa) subtitle script to plain SubRip (.srt).

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.