Skip to main content
Glama

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.

Country and shape mazes generated by mazediy-mcp

Tools

Tool

What it does

generate_maze

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.

list_countries

Lists the 237 country outlines, filterable by name or continent.

find_printable_mazes

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/mcp

Local server (Node.js 18 or later):

Claude Code

claude mcp add mazediy -- npx -y mazediy-mcp

Claude 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

shape-mazes.jsonl

2,000 shape mazes across 37 themes, identical to the mazes on MazeDIY's printable pages, with page, image and answer-key URLs.

country-shapes.json

237 country outlines rasterized to grids (longer side 96 cells), from Natural Earth.

country-mazes.jsonl

One perfect maze per country, with start, end and solution. Reproducible: npm run dataset.

us-state-mazes.jsonl

50 mazes from MazeDIY's printable collection (49 US states without Hawaii, plus Washington, D.C.), with solutions.

printable-mazes.json

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:

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

The 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 tools
find_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

    A3.9/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      1
      ISC
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -