# Random Picker — MCP tool `findutils:random_picker`

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

- Category: calculators
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/random-picker/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/random-picker/
- Same tool on the other surface: https://findutils.com/api/random-picker/

## Connect

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

Claude Desktop (`claude_desktop_config.json`):

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

## Call the tool (verified example)

```bash
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):

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

## Also a REST endpoint

```bash
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
curl https://api.findutils.com/api/tools/random-picker
```

Full REST reference: https://findutils.com/api/random-picker/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt