Random Group Generator

Randomly group input data into specified number of groups with flexible options

text· Text result

Quick start

Call this tool from your code in three languages.

cURL

curl -X POST 'https://api.elysiatools.com/en/api/tools/random-group-generator' \
  -H 'Content-Type: application/json' \
  -d '{"data":"Enter items to group, separated by newlines or custom separator","groupCount":2,"groupBy":"count","separator":"\\n","allowEmptyGroups":false,"maintainOrder":false,"showGroupNumbers":true,"prefix":"Group"}'

API reference

Send a POST request with your inputs as JSON. File parameters require a separate upload first.

Endpoint

HTTP

POST https://api.elysiatools.com/en/api/tools/random-group-generator

Parameters

Name	Type	Required	Description
data	textarea	Yes	—
groupCount	number	Yes	—
groupBy	radio	No	—
separator	text	No	Use \n for newlines, or specify custom separator
allowEmptyGroups	checkbox	No	Allow groups to be empty when items are fewer than groups

MCP integration

Add this tool to your Model Context Protocol server so AI agents can list and call it.

Server configuration

Add this block to your MCP client configuration:

mcp.json

{
  "mcpServers": {
    "elysiatools-random-group-generator": {
      "name": "random-group-generator",
      "description": "Randomly group input data into specified number of groups with flexible options",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=random-group-generator",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

List available tools

After connecting to the SSE endpoint, list the exposed tools:

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Call this tool

Invoke the tool by its id, passing arguments built from its parameters:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "random-group-generator",
    "arguments": {
  "data": "Enter items to group, separated by newlines or custom separator",
  "groupCount": 2,
  "groupBy": "count",
  "separator": "\\n",
  "allowEmptyGroups": false,
  "maintainOrder": false,
  "showGroupNumbers": true,
  "prefix": "Group"
}
  }
}

Chain multiple tools in one session with a comma-separated toolId list, e.g. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max 20).

Questions or issues? Contact [email protected]

Response format

Text result

JSON

{
  "result": "Processed text content",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}

Random Group Generator — API & MCP | Elysia Tools