# Vocabulary sorting activity

- Human page: https://happytails.ai/en/education-tools/vocabulary-sorting-activity/
- Markdown: https://happytails.ai/en/education-tools/vocabulary-sorting-activity.md
- Structured JSON: https://happytails.ai/agents/en/education-tools/vocabulary-sorting-activity/index.json
- Visibility: public

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `vocabulary-sorting-activity` |
| Category | education-tools |
| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |
| Browser execution | Use the visible action or interactive controls. |
| Browser processing | Browser; see tool notes for network behavior. |
| HTTP API | Not callable through HTTP. |
| Browser-agent interface | run_current_tool |

### Implementation notes

Enter terms with the categories you assign. The answer key repeats your categories; the tool does not check whether they are correct. Your list stays on this device.

### Inputs and settings

Text input: Your text.

Example or placeholder shown in the interface (not a validated fixture):

```text
Type or paste your input…
```

Up to 50,000 characters. Review the settings before running.

| Setting | Meaning | Control type | Default | Constraints |
| --- | --- | --- | --- | --- |
| `columns` | Cards per row | number | 3 | min=2 max=5 step=1 |
| `seed` | Seed | number | 1 | min=1 max=4294967295 step=1 |

### Browser-agent workflow

1. Open the human page in a browser that supports WebMCP.
2. Discover the interface exposed by that page; use its actual schema.
3. Select files on the page first when the tool requires files.
4. Call `run_current_tool` with valid input and settings.
5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.

Calls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.

### Planning specification

Up to 200 terms in 2 to 12 categories, with cells up to 80 characters and up to 50,000 input characters. The tool repeats your category assignments and does not check whether they are correct. Calculations stay on your device.

This describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.

### Complete machine-readable capability record

```json
{
  "id": "vocabulary-sorting-activity",
  "category": "education-tools",
  "built": true,
  "requirements": "Up to 200 terms in 2 to 12 categories, with cells up to 80 characters and up to 50,000 input characters. The tool repeats your category assignments and does not check whether they are correct. Calculations stay on your device.",
  "implementation": {
    "fields": [
      {
        "key": "columns",
        "label": "Cards per row",
        "value": 3,
        "type": "number",
        "min": 2,
        "max": 5,
        "step": 1
      },
      {
        "key": "seed",
        "label": "Seed",
        "value": 1,
        "type": "number",
        "min": 1,
        "max": 4294967295,
        "step": 1
      }
    ],
    "registrationFamily": "learning-activities-reference",
    "presentation": "metrics",
    "inputMaxLength": 50000,
    "inputErrorCode": "LEARNING_ACTIVITIES_REFERENCE_TOO_LONG",
    "note": "Enter terms with the categories you assign. The answer key repeats your categories; the tool does not check whether they are correct. Your list stays on this device.",
    "experience": {
      "automatic": false,
      "single": false,
      "inputMaxLength": 50000,
      "inputMode": "text",
      "label": "Your text",
      "placeholder": "Type or paste your input…",
      "help": "Up to 50,000 characters. Review the settings before running.",
      "helpParts": [
        "Up to 50,000 characters.",
        "Review the settings before running."
      ],
      "action": null
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}
```

## Page guide

Turn terms and categories you provide into shuffled sorting cards, headers and a separate answer key.

### How to use Vocabulary sorting activity

1. Paste a CSV with the header term,category and one term per row.
2. Choose how many cards to print in each row and set a seed for repeatable order.
3. Generate, then download the JSON report, answer-key CSV and printable cards.

How can we improve this tool?

Report a problem or share an idea.

Please leave out private information. Your message and the tool name go to our team via PostHog.

## Useful next steps

- [Flashcard maker](https://happytails.ai/en/education-tools/flashcard-maker/) ([Markdown](https://happytails.ai/en/education-tools/flashcard-maker.md))

- [Matching Worksheet Maker](https://happytails.ai/en/education-tools/matching-worksheet-maker/) ([Markdown](https://happytails.ai/en/education-tools/matching-worksheet-maker.md))

Up to 200 terms in 2 to 12 categories, with cells up to 80 characters and up to 50,000 input characters. The tool repeats your category assignments and does not check whether they are correct. Calculations stay on your device.

## Use your own categories

The answer key repeats the categories you assign. This tool does not decide whether a term belongs in a category.

### Repeat the card order

The same seed reproduces the same card order. Long terms wrap inside the printed card layout.

### Print the activity

Download the report and CSV, or print the separate HTML worksheet from your browser.
