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.
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.