# Vocabulary Worksheet — MCP tool `findutils:vocabulary_worksheet`

Turn a word list into a printable vocabulary and spelling worksheet with an answer key. Activities: scramble (unscramble the letters), missing_letters (fill in the blanks; the first letter stays), match_definitions (words against shuffled definitions; every word needs one), word_search (letter grid up to 15×15, words across, down and diagonally), and trace (copy practice). Returns each section as data plus plain text, an answer key and Markdown. Pass a seed for a reproducible sheet.

- Category: education
- 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/vocabulary-worksheet/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/vocabulary-worksheet/
- Same tool on the other surface: https://findutils.com/api/vocabulary-worksheet/

## 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": "vocabulary_worksheet",
      "arguments": {
        "words": "elephant: a very large grey animal\ngiraffe: the tallest animal\npenguin: a bird that cannot fly",
        "seed": 1
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `words` | string | yes | The words, one per line (or an array of lines), at most 40. Add a definition after a colon, a tab or " - ": "elephant: a very large grey animal". Duplicates are dropped. |
| `activities` | array | no | Which activities to include, in this order. Default: scramble, missing_letters, word_search — plus match_definitions when every word has a definition. |
| `title` | string | no | Worksheet title. Default "Vocabulary Worksheet". |
| `seed` | integer | no | Random seed. Same seed and words → same worksheet. |

Example arguments (verified):

```json
{
  "words": "elephant: a very large grey animal\ngiraffe: the tallest animal\npenguin: a bird that cannot fly",
  "seed": 1
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/vocabulary-worksheet/execute \
  -H "Content-Type: application/json" \
  -d '{
    "words": "elephant: a very large grey animal\ngiraffe: the tallest animal\npenguin: a bird that cannot fly",
    "seed": 1
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/vocabulary-worksheet
```

Full REST reference: https://findutils.com/api/vocabulary-worksheet/ · 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