Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

PuzzleTide

NPM · PUZZLETIDE-MCP · SCANNED AUG 3

Word search, crossword, and sudoku generators, printable PDF worksheets, and verifiable LLM evals.

Available components

+23 this week 68 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (102 of 106), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (102 of 106), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability71
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 2084 tokens (~138/item across 15 items; 15 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · puzzletide-mcp

# add to Claude Code
claude mcp add catorch-puzzletide -- npx -y puzzletide-mcp
# add to Codex CLI
codex mcp add catorch-puzzletide -- npx -y puzzletide-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "catorch-puzzletide": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "puzzletide-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add catorch-puzzletide --command npx --arg -y --arg puzzletide-mcp
# ~/.hermes/config.yaml
mcp_servers:
  catorch-puzzletide:
    command: "npx"
    args: ["-y", "puzzletide-mcp"]
// mcp.json
{
  "mcpServers": {
    "catorch-puzzletide": {
      "command": "npx",
      "args": [
        "-y",
        "puzzletide-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +4
    • Stability: unverified → 0.27 functional
  • 2 Aug 26 +44
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Schema quality: unverified → excellent functional
    • License: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • Licence: MIT functional
  • 31 Jul 26 +14
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −39
    • Malware scan: pass → unverified security
    • Tool coverage: 100 → unverified functional
    • First check of Schema quality: unverified functional
  • 27 Jul 26 45

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 102 packages

102 packages in the resolved dependency tree · 101 deprecated · 32 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 15 exposed · ~2,000 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
eval_check ~98

Grades a JSON answers file against a tasks file produced by eval generate. Verification is by construction: sudoku answers must satisfy sudoku rules and preserve the givens; word search answers must spell the word along a straight line in the grid. Outputs per-task results and a score summary.

NameTypeReqDescription
answersstring|numberJSON array of {id, answer} (required)
tasksstring|numberTasks JSON from eval generate (required)

No output schema declared.

No examples provided.

eval_generate ~183

Emits a JSON array of puzzle tasks with objectively checkable answers. Types: sudoku (unique-solution puzzles; answers verified against sudoku rules + givens) and wordsearch (answers verified against the grid letters). Deterministic with --seed, so a (seed, type, difficulty, n) tuple names a reproducible benchmark set.

NameTypeReqDescription
difficultystring|numbersudoku: easy|medium|hard|expert; wordsearch: easy|medium|hard (default: medium)
nstring|numberNumber of tasks (default: 10)
outstring|numberWrite tasks JSON to a file instead of stdout
seedstring|numberSeed for a reproducible task set (default: 1)
typestring|numberTask type: sudoku or wordsearch (default: sudoku)

No output schema declared.

No examples provided.

play_daily ~38

Prints a daily sudoku (medium difficulty) that is the same for everyone on the same UTC calendar day. Solve more puzzles at puzzletide.com.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

puzzle_crossword_generate ~332

Builds an interlocking crossword grid with standard numbering. Words come from --words "WORD: clue; WORD2: clue2", --file (JSON [{word,clue}] or "WORD: clue" lines), or --theme (clues are auto-generated puzzle-style hints). Words that cannot interlock are reported as unplaced. Deterministic with --seed. Online version: https://puzzletide.com/crossword

NameTypeReqDescription
countstring|numberNumber of words to use from the theme/file (default: 10)
filestring|numberJSON array of {word, clue} or "WORD: clue" lines
paperstring|numberPDF paper size: letter or a4 (default: letter)
pdfstring|numberAlso write a printable PDF worksheet to <file>
seedstring|numberSeed for reproducible output (number or word)
sizestring|numberWorking grid size before trimming (5-25) (default: 15)
solutionbooleanPrint the solution instead of the puzzle
solutionPagebooleanOmit the solution page from PDF output — set false to disable
svgstring|numberAlso write an SVG image to <file>
themestring|numberUse a bundled word bank theme (auto-generated clues)
titlestring|numberTitle used in SVG/PDF output
wordsstring|numberSemicolon-separated "WORD: clue" pairs

No output schema declared.

No examples provided.

puzzle_sudoku_generate ~223

Generates a 9x9 sudoku at easy/medium/hard/expert difficulty. Every puzzle is verified to have exactly one solution. Deterministic with --seed. The canonical string format is 81 characters, row by row, "." for empty cells. Online version: https://puzzletide.com/sudoku

NameTypeReqDescription
difficultystring|numberOne of: easy, medium, hard, expert (default: medium)
paperstring|numberPDF paper size: letter or a4 (default: letter)
pdfstring|numberAlso write a printable PDF worksheet to <file>
seedstring|numberSeed for reproducible output (number or word)
solutionbooleanPrint the solution instead of the puzzle
solutionPagebooleanOmit the solution page from PDF output — set false to disable
svgstring|numberAlso write an SVG image to <file>
titlestring|numberTitle used in SVG/PDF output

No output schema declared.

No examples provided.

puzzle_sudoku_solve ~119

Solves a 9x9 sudoku via backtracking. Input: 81 characters row by row with 1-9 for givens and 0/./_ for empty cells (whitespace and separators are ignored), passed inline, via --file, or on stdin. Reports whether the solution is unique. Online version: https://puzzletide.com/sudoku

NameTypeReqDescription
filestring|numberRead the grid from a file
gridstring81-character puzzle string (or "-" for stdin)

No output schema declared.

No examples provided.

puzzle_sudoku_validate ~97

Checks a 9x9 sudoku grid for well-formedness, conflicting givens, solvability, and whether the solution is unique (a proper sudoku has exactly one). Same input formats as sudoku solve. Online version: https://puzzletide.com/sudoku

NameTypeReqDescription
filestring|numberRead the grid from a file
gridstring81-character puzzle string (or "-" for stdin)

No output schema declared.

No examples provided.

puzzle_wordsearch_generate ~431

Places every word in a letter grid (8 possible directions, difficulty presets) and fills the rest with random letters. Deterministic with --seed. Words come from --words, --file (one per line), or --theme (bundled PuzzleTide word banks). Output: text grid, --json structured data, --svg image, or --pdf printable worksheet with solution page. Online version: https://puzzletide.com/word-search

NameTypeReqDescription
colsstring|numberGrid columns (overrides --size)
countstring|numberNumber of words to use from the theme/file (default: 12)
difficultystring|numberDirection preset: easy (E,S), medium (+diagonals), hard (all 8) (default: medium)
directionsstring|numberExplicit directions (comma-separated from: N,NE,E,SE,S,SW,W,NW)
filestring|numberRead words from a file (one per line or comma-separated)
paperstring|numberPDF paper size: letter or a4 (default: letter)
pdfstring|numberAlso write a printable PDF worksheet to <file>
rowsstring|numberGrid rows (overrides --size)
seedstring|numberSeed for reproducible output (number or word)
sizestring|numberSquare grid size (6-30); computed from words if omitted
solutionbooleanPrint the solution instead of the puzzle
solutionPagebooleanOmit the solution page from PDF output — set false to disable
svgstring|numberAlso write an SVG image to <file>
themestring|numberUse a bundled word bank theme (see: ptide words themes)
titlestring|numberTitle used in SVG/PDF output
wordsstring|numberComma-separated words, e.g. "cat,dog,fish"

No output schema declared.

No examples provided.

words_anagram ~52

Finds single-word anagrams of the given letters within the bundled word bank sample.

NameTypeReqDescription
lettersstringyesLetters to rearrange
limitstring|numberMaximum results (default: 50)

No output schema declared.

No examples provided.

words_categories ~30

Lists the bundled PuzzleTide word bank categories (animals, geography, holidays, ...) with their theme counts.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

words_list ~114

Prints the words of one bundled theme, optionally filtered by length, shuffled by --seed, and limited by --count. Useful as input for generators or other tools.

NameTypeReqDescription
countstring|numberMaximum number of words
maxLengthstring|numberMaximum word length
minLengthstring|numberMinimum word length
seedstring|numberShuffle deterministically before applying --count
themestringyesTheme id, e.g. animals/ocean-animals

No output schema declared.

No examples provided.

words_match ~78

Matches the bundled word bank sample against a pattern where "_" or "?" is any letter, e.g. "c_r_l" matches CORAL. Helpful when stuck on a crossword or word puzzle.

NameTypeReqDescription
limitstring|numberMaximum results (default: 50)
patternstringyesPattern with _ or ? wildcards

No output schema declared.

No examples provided.

words_random ~80

Picks a random word from the bundled word banks — the same pool the hangman game uses. Deterministic with --seed.

NameTypeReqDescription
minLengthstring|numberMinimum word length (default: 4)
seedstring|numberSeed for reproducible output
themestring|numberRestrict to one theme

No output schema declared.

No examples provided.

words_stats ~24

Prints the size of the bundled word bank: categories, themes, unique words.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

words_themes ~101

Lists the bundled starter themes (30 generic word lists; the full curated collection is at puzzletide.com). Filter by --category or full-text --search. Theme ids look like "animals/ocean-animals".

NameTypeReqDescription
categorystring|numberOnly themes in this category
limitstring|numberMaximum results (default: 50)
searchstring|numberFull-text search over id, title, and description

No output schema declared.

No examples provided.