Crossword Tools

Provides crosswords solving capabilities by loading grid and clues, registering candidates, validating consistency, and rendering the final grid.

python

4

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "watamoo-mcp-crossword-tools": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "src/server.py"
      ]
    }
  }
}

You run the Crossword MCP Server to assist crossword solving by loading a grid and clue definitions, registering candidate words, checking consistency, and rendering the final board. It streamlines candidate management and allows you to explore consistent word combinations before drawing the solved grid.

How to use

You interact with the server using an MCP client session. Start by initializing the server with the grid and clue data, then add candidate words that match each clue’s length. You can request the current candidate lists for any clue, explore all combinations that satisfy all clues, and finally render the complete solution on the board.

How to install

Prerequisites you need before running the server are Python 3.11 or later and the uv runner. Dependencies are installed automatically when you start the server with the supported runner, so you do not need to run separate pip install commands.

Step-by-step setup and run flow you can follow when you have the grid and clue data prepared:

Additional notes

The server exposes a set of tools to manage and solve the crossword. You can initialize state, register candidates that match clue lengths, retrieve candidates for a clue, enumerate consistent sets across clues, render the final solution on the board, and orchestrate the full solving flow.

Available tools

setup

Initialize the server state by loading the grid data and key (clue) definitions from the configured data sources.

register_candidates

Add candidate words that match the length of each clue. Existing candidates are kept and duplicates are ignored.

get_candidates

Retrieve the list of candidate words for a specified clue by its identifier.

search_consistent_sets

Exhaustively search all candidate combinations to find sets that satisfy all clue constraints simultaneously.

render_solution

Apply the final solution (shown in hiragana) to the grid and render a neatly formatted board.

solve_crossword

Combine the above tools to drive the solving process from initialization to final rendering.