MazeDIY MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MazeDIY MCP make a 25x25 heart-shaped maze with an answer key"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MazeDIY MCP: maze generator and country maze dataset
Generate printable mazes in any shape, including the outline of 237 countries, straight from Claude, Cursor or any MCP client. Every maze has exactly one solution and comes with an answer key. The server can also search 2,000+ free printable mazes from MazeDIY.
The repository also ships the data as an open dataset: 2,000 shape mazes (animals, dinosaurs, vehicles, food and more) that match MazeDIY's printable pages, 237 country-shaped mazes and 50 US state mazes, each with its grid, solution path and image links. Browse the country maze gallery.

Tools
Tool | What it does |
| Makes a maze as SVG (for printing), ASCII (for chat) or JSON. Shapes: rectangle, circle, heart, star, diamond, triangle, hexagon, or any country by name or ISO code. Options: size, seed, answer key. |
| Lists the 237 country outlines, filterable by name or continent. |
| Searches ready-made printable mazes on MazeDIY (animals, dinosaurs, holidays, vehicles, US states and more), each with a print page and answer key. |
Example prompts:
"Make a 25x25 heart-shaped maze for my daughter, with an answer key."
"Generate a maze in the shape of Japan for a geography lesson."
"Find a printable dinosaur maze."
Related MCP server: search-memory-mcp
Install
Remote server, nothing to install: add https://mazediy.com/mcp as a remote MCP server (Streamable HTTP, no sign-in).
claude mcp add --transport http mazediy https://mazediy.com/mcpLocal server (Node.js 18 or later):
Claude Code
claude mcp add mazediy -- npx -y mazediy-mcpClaude Desktop, Cursor, Windsurf and other clients: add to the client's MCP config:
{
"mcpServers": {
"mazediy": {
"command": "npx",
"args": ["-y", "mazediy-mcp"]
}
}
}VS Code
code --add-mcp '{"name":"mazediy","command":"npx","args":["-y","mazediy-mcp"]}'Dataset
All files are in data/. Format details are in data/README.md.
File | Contents |
| 2,000 shape mazes across 37 themes, identical to the mazes on MazeDIY's printable pages, with page, image and answer-key URLs. |
| 237 country outlines rasterized to grids (longer side 96 cells), from Natural Earth. |
| One perfect maze per country, with start, end and solution. Reproducible: |
| 50 mazes from MazeDIY's printable collection (49 US states without Hawaii, plus Washington, D.C.), with solutions. |
| Index of 2,145 printable mazes on mazediy.com with page, image and answer-key URLs. |
Uses: visual reasoning benchmarks (can a model solve the maze in the image?), maze-solving and path-finding benchmarks, reinforcement learning environments, geography games, and teaching search algorithms such as BFS and A*.
Want more than a plain maze?
MazeDIY turns your own photo, a child's name or a hidden message into a printable maze, with print-ready PNG and PDF downloads:
Picture maze maker: a maze in the shape of your photo
Development
npm install
npm test # generator, every country, and the MCP server over stdio
npm run dataset # rebuild data/country-mazes.jsonl
python3 scripts/build-country-shapes.py ne_50m_admin_0_countries.geojson data/country-shapes.jsonThe outlines come from the Natural Earth 1:50m Admin 0 countries file. Small distant territories are left out, and islands are joined to the mainland by one-cell causeways so every maze is a single solvable region. Country names follow Natural Earth and are not a position on any border dispute.
License
Code: MIT. Data in data/: CC BY 4.0. Please credit "MazeDIY (https://mazediy.com)" when you use the dataset. Natural Earth outlines are public domain.
Available Tools
3 toolsfind_printable_mazesFind ready-made printable mazesA
Search 2,000+ free printable mazes on MazeDIY (animals, dinosaurs, holidays, vehicles, food, US states and more). Each result links to a page with a print-ready maze and its answer key. Leave the query empty to list themes.
Inputs: limit, query, theme.
generate_mazeGenerate a mazeA
Generate a printable maze as SVG, ASCII text or JSON. Shapes: rectangle, circle, heart, star, diamond, triangle, hexagon, or the outline of any country (pass country). Every maze has exactly one solution; set show_solution for an answer key. The same seed always gives the same maze.
Inputs: seed, size, shape, width, +4 more.
list_countriesList country shapesA
List the countries available for country-shaped mazes. Filter by part of a name or code, or by continent (Africa, Asia, Europe, North America, South America, Oceania, Antarctica).
Inputs: query, continent.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a clearly distinct action: generating a maze, listing the country catalog used by the generator, and searching a separate library of pre-made printable mazes. There is no realistic path for an agent to confuse `list_countries` with `find_printable_mazes`, since one is a static enum lister and the other is a text search over external content.
All three names follow a strict verb_noun snake_case pattern: generate_maze, list_countries, find_printable_mazes. The verbs (generate/list/find) accurately signal the differing operations, so the convention is both consistent and informative.
Three tools is on the thin side but well matched to a focused maze generator plus content search server; nothing feels padded. `list_countries` is arguably a helper for `generate_maze`, but it earns its place given the size of the country dataset.
The core lifecycle is covered: produce a maze in multiple formats with an optional solution key, discover valid country inputs, and find pre-made printable mazes. The main gap is that `find_printable_mazes` only returns links, with no companion tool to fetch a specific maze's details or answer key directly.
Maintenance
Related MCP Connectors
Make printable mazes for parents, teachers and puzzle fans as a PDF with an answer key.
Find published word searches, crosswords and mazes with matching Letter and A4 PDF files.
Make printable nonogram puzzles for teachers, students and puzzle fans as a PDF with an answer key.
Number puzzle API + MCP: solver-checked puzzles as JSON/SVG, daily puzzle. $5/mo; 50 free/day.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to explore a public-domain poetry collection by searching poems by title, finding poems whose lines contain a given phrase, pulling one or more random poems, and listing available authors. It returns full poem text with author and line-count details, and works either through a hosted gateway or as a local stdio server without an account.96 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to run offline-first web search, fetch and extract web content, build a local hybrid-retrieval knowledge base, and use persistent session memory without external API keys. It also supports intent-aware federated search, semantic reranking, entity graph exploration, and source-cited deep-search answers using local models.135 npm1ISC
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to search the web through configured providers and crawl individual pages or entire sites into clean Markdown or JSON, including authenticated browsing and deduplicated output. It can run locally over STDIO or HTTP and integrates with MCP clients and command-line workflows.-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to search and filter titles, browse rankings, read comments, manage favorites, download albums, chapters, and covers with live progress, cancellation, and retry, and convert downloads into ZIP, PDF, or long images, all through natural language. Exposes 21 tools and 3 knowledge resources over stdio, SSE, and HTTP transports, along with runtime configuration and account login.-