The puzzle generator MCP server gives an MCP-compatible AI host access to eight puzzle-link tools. Your assistant supplies the words, clues, phrases, or layout settings; JigsawMake validates them and returns a link to the appropriate browser generator. Open that link to review the puzzle and save it using the tool’s existing download controls.
This server connects AI workflows to puzzle makers. It does not access accounting data, private designs, or user accounts.
Test an MCP ToolSign in to create an API key. Create and delete keys and view call history in your account.
Prefer ordinary HTTP requests? See the Puzzle Generator API.
Run a sample tools/call request through the real MCP endpoint to inspect its returned URL and structured content. This console verifies a server call, not a connection to a particular AI host. For a complete integration, add the endpoint to your MCP client, discover the tool list there, and ask the assistant to create a puzzle using your own public content.
Sign in to create or manage API keys. Your key stays in memory in this console.
Use public content. These settings will appear in the returned URL.
Configuration
MCPSign in to create or manage API keys. Your key stays in memory in this console.
Use public content. These settings will appear in the returned URL.
POST https://jigsawmake.com/api/mcp
Run a sample to see the response and a working preview link. No request is made until you press the button.
The server exposes list_puzzle_tools plus one creation tool for each of the eight puzzle categories. Each creation tool advertises its argument schema and optional registered page choices. A host can discover the supported inputs rather than guessing URLs, while the server checks that the arguments match the selected puzzle type.
An assistant can draft an ocean vocabulary list or crossword clues, then supply that content to the matching tool. This server does not call another language model to generate text. The result is a browser link that a person can review and edit, keeping content quality checks visible before a worksheet is printed.
The tools create links to public editors. They do not read private saved designs, make purchases, or log into an account. Sign in to create an API key and configure the host to send Authorization: Bearer YOUR_API_KEY. This key grants access to puzzle-link tools, not your private designs or billing. Delete it and review call history in your account. Your AI host still controls which tools it allows and when it asks for approval to call them.
Sign in at /dashboard and create an API key. Configure Authorization: Bearer YOUR_API_KEY and use https://jigsawmake.com/api/mcp in a client that supports Streamable HTTP. The endpoint uses stateless requests; GET streams and DELETE sessions are not provided. Client configuration syntax differs, so use the URL and transport fields supported by your host.
Ask the host to list the server’s tools. list_puzzle_tools describes the categories, their parameter schemas, and registered pages. The eight creation tools have names such as create_word_search_link and create_crossword_link, making the content-to-tool mapping explicit.
Ask for a specific activity, such as an ocean word search with a 12×12 grid. The assistant must supply a words array in the tool arguments; a topic alone is not a valid replacement. For crosswords, it supplies answer words and their clues.
The response includes structured content, a text representation, and a resource link to the editor. Open the URL to check the supplied settings and the generated preview. Use the page’s download controls to save the worksheet or cut pattern in a supported format.
There is one discovery tool and eight creation tools, rather than a different MCP tool for every themed page. Each category’s optional page argument lets the assistant choose one of its registered pages. The catalog below comes from the same registry used by the server, so it describes the existing categories instead of a separate marketing-only tool list.
| Puzzle | MCP tool | Sample input fields | What you can create |
|---|---|---|---|
| Jigsaw MCP ToolJigsaw Generator | create_jigsaw_link | shape, tilesX, tilesY, sizeX, sizeY, seed | Configure piece counts, shape, dimensions, and a seed for a cut-pattern preview. Add an optional HTTPS image URL for a photo puzzle. |
| Word Search MCP ToolWord Search Generator | create_word_search_link | title, words, gridSize, diagonal | Supply a word list, grid size, and direction settings to prepare a vocabulary worksheet that users can review in the browser. |
| Crossword MCP ToolCrossword Generator | create_crossword_link | title, clues | Send answer-and-clue pairs for a connected crossword preview. Review placement in the editor before exporting the worksheet. |
| Sudoku MCP ToolSudoku Generator | create_sudoku_link | gridSize, difficulty, pageCount, puzzlesPerPage, paperSize | Choose grid size, difficulty, puzzles per page, and paper size. The browser generates the Sudoku worksheet and handles its downloads. |
| Bingo MCP ToolBingo Generator | create_bingo_link | title, gridSize, cardCount, items | Provide custom bingo items or choose a blank template, along with grid size and card count. Open the link to review the cards before printing. |
| Maze MCP ToolMaze Generator | create_maze_link | cols, rows, algorithm, seed | Choose rows, columns, an algorithm, and an optional seed. Preview the maze and use the browser’s puzzle and answer-key downloads. |
| Cryptogram MCP ToolCryptogram Generator | create_cryptogram_link | sourceText, difficulty | Supply a phrase and difficulty for a letter-substitution activity. Review the cipher and save the worksheet through the browser editor. |
| Word Scramble MCP ToolWord Scramble Generator | create_word_scramble_link | words, difficulty | Supply five to twenty-five English words and a difficulty. Review the shuffled spelling activity before saving a worksheet or using online play. |
For an HTTP client, register the remote endpoint as a Streamable HTTP server. For a local stdio client, set JIGSAWMAKE_API_KEY and run scripts/puzzle-mcp.mjs with Node.js 22 or newer; this adapter forwards calls to the authenticated remote server so calls are recorded; the repository also provides npm run mcp:stdio for terminal use. Launch Node directly in desktop configuration so npm’s own logs do not enter the protocol stream. Do not add an npx package name: this server has not been published as an installable npm package.
A creation tool takes options and an optional page, then returns type, page, url, normalized options, resultType, and instructions. Its resource_link points to an HTML tool page. Your AI host may display that as a clickable link or as structured data; the exact presentation belongs to the client. A successful tools/call response does not prove the host has opened a browser or downloaded a file.
Browser-based MCP hosts must send an allowed Origin. Production permits the JigsawMake origins; additional trusted origins require server configuration. Desktop callers without an Origin are supported. The server also validates content size and limits requests. Keep the puzzle content public, because settings travel in the URL, and remember that randomized layouts may change when that URL is reopened.
Request GET /api/v1/tools with your API key, and read the OpenAPI schema for the complete parameter definitions. Keep production keys in your backend; the JavaScript sample is for a trusted environment.
HTTP configuration example (host-dependent)
{
"mcpServers": {
"jigsawmake": {
"url": "https://jigsawmake.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Local stdio configuration
{
"mcpServers": {
"jigsawmake": {
"command": "node",
"args": [
"--disable-warning=MODULE_TYPELESS_PACKAGE_JSON",
"/absolute/path/to/jigsaw-puzzle/scripts/puzzle-mcp.mjs"
],
"env": {
"JIGSAWMAKE_API_KEY": "YOUR_API_KEY"
}
}
}
}Have the assistant select vocabulary from a lesson and call the word-search tool. Ask it to check spelling and age suitability before the teacher opens the browser preview and prints the worksheet.
Let an assistant draft answer-and-clue pairs, then call create_crossword_link. The returned page provides a visible review step; the assistant should not infer that every submitted answer has become a connected crossword entry.
Ask for a bingo item list appropriate to an event, then create a card-generator link. Review sensitive or unsuitable suggestions before printing, and use the browser to check the desired number of cards.
Request a jigsaw shape and dimensions or a seeded maze configuration. The host passes supported values to a link tool; the human then chooses the appropriate export format in the browser editor.
Supply a public phrase to create_cryptogram_link and choose a supported difficulty. The assistant provides the source text, while the destination generator creates the cipher preview and exposes the worksheet and answer downloads.
Choose five to twenty-five English words and call create_word_scramble_link. The tool validates length and uniqueness; the teacher or learner checks the scrambled worksheet in the browser before using it in an activity.
Creation tools return a prefilled browser tool-page link, structured data, and a text representation. The user opens the link to generate or inspect a preview, edit settings, and download a file. The server does not attach a finished PDF to the MCP response or persist the generated worksheet as a remotely stored artifact.
Use a host that supports the transport you choose: Streamable HTTP for the remote endpoint or stdio for a local checkout. Configuration fields and account requirements vary by host. This page provides the server URL, tool names, and argument examples; it does not claim every named client or account plan has been individually tested.
The calling assistant or application supplies the words in options.words when calling create_word_search_link. It can derive them from a lesson or use a list you provide. JigsawMake validates the list and returns a configured editor link. The MCP server itself does not make another AI request to invent themed vocabulary.
No. This server exposes discovery and public puzzle-link creation. It does not read saved designs, expose a session, or perform purchases. The generated settings are visible in the URL, so use public puzzle content. An MCP host’s own data handling and tool-permission rules still apply to conversations and requests made through that host.
A browser client can fail if its API key is missing or deleted, its Origin is not allowed, its request does not match the supported protocol, or it expects a GET stream or stateful session. The endpoint supports stateless Streamable HTTP creation calls. Check the response and your host’s transport support, and configure an additional trusted Origin on the server when needed.
MCP packages discovery and link creation as named tools for an AI host. The HTTP API exposes the same puzzle settings through ordinary JSON endpoints for application code. Both return links to browser generators, and both leave preview and download to those pages. Choose based on how your caller discovers tools and submits arguments.
Try the destination tools before adding an automated workflow. A preview helps you understand which settings your assistant needs to supply and which decisions remain with the person printing the activity. For direct application code, use the separate HTTP API reference rather than reproducing MCP envelopes in a backend that only needs a JSON link response.
Connect your client, discover the puzzle tools, and open your first link to review and download.