PuzzleTide MCP server

<!-- Keyword rationale (d4s / DataForSEO, 2026-07-16, google en): word search generator 33,100/mo KD37 · word search maker 33,100 KD40 · sudoku solver 40,500 KD41 sudoku generator 1,000 KD9 · sudoku puzzle generator 170 KD10 · crossword generator 12,100 KD51 printable word search 18,100 KD5 · printable sudoku puzzles 4,400 KD15 · expert sudoku 2,400 KD0 daily sudoku 27,100 KD37 · hangman game 40,500 KD35 · llm evals 480 KD28 Dev modifiers (cli/npm/javascript/github variants) are all ≤10/mo — the surfaces that matter are GitHub search, npm search, and Google snippets of the repo page, all of which read the repo description, package.json description/keywords, and README H1/H2s. Contiguous phrases to keep intact: "word search generator", "crossword generator", "sudoku generator", "sudoku solver", "printable word search", "printable sudoku", "expert sudoku", "daily sudoku", "LLM evals", "puzzle generator CLI", "MCP server". Top-page deep links (GSC 2026-07, by clicks): mystery-and-murder printable word search (237), /hangman (25), /printable (10), dyslexic-friendly blog post (9), /maker (4). Banned claims (not shipped): word search solver, crossword solver, anagram solver (word tools search only the 30 starter banks), MCP server, PNG output, AI clue generation, nonograms/cryptograms, speed guarantees for expert sudoku, "full English dictionary". IP rule: the package ships only the 30 generic starter themes in scripts/wordbanks-source.json — NEVER include or reference-compile the proprietary puzzletide.com word bank dataset here. -->

PuzzleTide CLI — word search, crossword & sudoku generator

Word search generator, crossword generator, and sudoku generator + solver in one local-first puzzle generator CLI — with printable PDF worksheets, starter word banks, verifiable LLM evals, and bundled agent skills. From the makers of puzzletide.com.

Install

npm install -g puzzletide
ptide --version

The package installs both binaries:

• ptide
• puzzletide

Why generate puzzles with a CLI

Ask a language model to write a word search and you get a grid where half the words are broken; ask it for a sudoku and you usually get one with several solutions, or none. Grids are exactly the kind of output LLMs are bad at and deterministic code is good at.

PuzzleTide CLI is that deterministic code:

part of the output, and the generators are property-tested.

• Every word search word is placed and verifiable — placement coordinates are

• Every generated sudoku is checked to have exactly one solution.
• Every crossword is validated against its own clues before it's returned.
• Same --seed in, same puzzle out, on any machine.

The package also ships SKILL.md agent skills, so coding agents (Pi, Hermes, OpenClaw, and other SKILL.md-based systems) reach for the CLI instead of hand-writing grids.

Command model

ptide <namespace> <operation> [input] [options]   # for humans
ptide run <tool-id> [input] [options] --json      # canonical, for scripts/agents
ptide tools list | search <q> | info <id> | docs <id>
ptide agent manifest

Use short commands interactively and canonical tool ids in automation:

ptide sudoku generate --difficulty hard
ptide run puzzle.sudoku.generate --difficulty hard --json

Word search generator

Shortened. The full README is on GitHub.