MCP.so
Sign In

PuzzleTide Puzzle GeneratorVerifiedFeatured

@Caravaca-Labs

RepositoryHomepageDocumentation

About PuzzleTide Puzzle Generator

Word search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers

#puzzletide#puzzle-generator#word-search#crossword#sudoku#sudoku-solver#printable-puzzles#worksheets#pdf#word-games#llm-evals

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "puzzletide": {
      "command": "npx",
      "args": [
        "-y",
        "puzzletide-mcp"
      ]
    }
  }
}

Tools

15

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.

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.

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

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

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

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

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

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

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

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

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.

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.

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

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

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".

Overview

What is PuzzleTide?

PuzzleTide is a local-first MCP server for puzzle generation: a word search generator, crossword generator, and sudoku generator + solver in one package. Ask a language model to hand-write a word search and half the words break; ask it for a sudoku and you get one with several solutions. PuzzleTide is the deterministic code agents should call instead — every word search placement is verifiable, every sudoku is checked to have exactly one solution, and every crossword is validated against its own clues. Same seed in, same puzzle out.

Setup

{
  "mcpServers": {
    "puzzletide": {
      "command": "npx",
      "args": ["-y", "puzzletide-mcp"]
    }
  }
}

Works with Claude Desktop, Cursor, Windsurf, and any MCP client. Everything runs locally — no account, API key, telemetry, or network access.

Tools (15)

  • puzzle_wordsearch_generate — word search from custom words or 30 themed word banks; 8 directions with kid-friendly presets
  • puzzle_crossword_generate — interlocking crossword grids with standard numbering and validated clues
  • puzzle_sudoku_generate — easy, medium, hard, and expert sudoku with a unique-solution guarantee
  • puzzle_sudoku_solve / puzzle_sudoku_validate — instant solver; conflict and uniqueness checks
  • words_themes, words_list, words_match, words_anagram, words_random, words_categories, words_stats — word bank browsing, crossword-style pattern matching, anagrams
  • eval_generate / eval_check — reproducible puzzle tasks with by-construction grading for benchmarking LLMs (no answer key to trust, no LLM judge)
  • play_daily — a shared daily sudoku

Key features

  • Printable PDF puzzle worksheets: pass a pdf file path to any generator and get a print-ready sheet with puzzle and solution pages (letter or A4), plus SVG output
  • Deterministic seeds — reproducible puzzles for teachers, activity packets, and benchmark sets
  • Verifiable LLM evals: a sudoku answer either satisfies the rules or it doesn't; a word search answer either spells the word in the grid or it doesn't
  • Property-tested generators shipped as the open-source puzzletide CLI (ptide)

Use cases

  • Generate a printable word search for a classroom, party, or activity book in one prompt
  • Create sudoku packets at graded difficulties with answer keys
  • Build crosswords from your own word/clue lists
  • Benchmark a model's reasoning with reproducible, objectively gradable puzzle tasks

Play online

Prefer a browser? Play free at https://puzzletide.com

FAQ

Does it need an API key?

No. All generation runs locally over stdio via the puzzletide-mcp npm package.

Can it make printable puzzles?

Yes — every generator accepts pdf and svg file-path arguments and writes print-ready worksheets with solution pages.

Comments

Basic information

Category

Developer Tools

License

MIT

Author

Caravaca-Labs

Submitted by

catorch

More Developer Tools MCP servers

Windframe

Windframe MCP gives your AI the design taste needed to create consistent, production-ready UI that feels intentionally designed. Available at https://windframe.dev/mcp

Skycloak

Manage your Skycloak-hosted Keycloak: clusters, realms, apps, SSO and users, from any MCP client.

directree

coburn2716

directree MCP server — query the honest software directory from any AI assistant

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

1

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.