Skip to content
MCP server

PlayBalanceGrid Puzzle Tools

Generate, validate and get hints for Takuzu (Binairo) puzzles in 6x6 to 10x10 grids

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.1
Listing updated
2 days ago

About PlayBalanceGrid Puzzle Tools

PlayBalanceGrid Puzzle Tools is an open-source MCP server for games and play. It runs locally on your machine and is started by your AI client.

Takuzu, also called Binairo, asks you to fill a grid with two kinds of cells so that each row and column stays balanced, no three identical cells sit in a row, and no two lines match. This server wraps those rules as three tools so an assistant can make puzzles, check answers and nudge a player along without guessing the rules itself.

The generator supports 6x6, 8x8 and 10x10 boards. A validator checks a completed grid against every rule, and a hint tool suggests the next move. It runs locally over stdio from the npm package, or from a cloned repository with node, and the README shows a Claude Desktop entry.

It comes from the team behind PlayBalanceGrid, a free browser game with a daily 6x6 puzzle and eighteen practice puzzles. The site says every published puzzle has exactly one solution that can be reached by reasoning alone. The README states an MIT licence.

Install

Run in a terminal

claude mcp add puzzle-tools -- npx -y playbalancegrid-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "puzzle-tools": {
      "command": "npx",
      "args": [
        "-y",
        "playbalancegrid-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "puzzle-tools": {
      "command": "npx",
      "args": [
        "-y",
        "playbalancegrid-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "puzzle-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "playbalancegrid-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "puzzle-tools": {
      "command": "npx",
      "args": [
        "-y",
        "playbalancegrid-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "puzzle-tools": {
      "command": "npx",
      "args": [
        "-y",
        "playbalancegrid-mcp-server"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

generate_puzzle
Generates a Takuzu puzzle in 6x6, 8x8 or 10x10.
validate_solution
Validates a completed puzzle against all Takuzu rules.
get_puzzle_hint
Gives a hint for the next move.

What it does

Puzzle generation
Create a Takuzu puzzle in 6x6, 8x8 or 10x10 size.
Solution validation
Check a completed grid against all Takuzu rules.
Next-move hints
Ask for a hint toward the next cell to fill.
Local stdio server
Runs on your machine from an npm package with no remote service.
MIT licence
The README states the code is MIT licensed.

Good for

  • Have an assistant generate a fresh 8x8 puzzle to play
  • Check a finished grid for rule violations
  • Get a hint when stuck on a puzzle
  • Build a logic-puzzle teaching bot that explains each move

Pricing

Open source

MIT licence

Prices change. Check playbalancegrid.com before you buy.

PlayBalanceGrid Puzzle Tools FAQ

What grid sizes can it generate?

6x6, 8x8 and 10x10.

Is it free?

The README says it is MIT licensed, and the companion game is free to play in the browser.

How do I add it to Claude Desktop?

Add a stdio entry that runs node on the repository's src/index.js, as shown in the README.

What are the Takuzu rules?

Each row and column is balanced between the two cell types, no three identical cells are consecutive, and no two rows or two columns are identical.

Is PlayBalanceGrid Puzzle Tools free?

Yes. PlayBalanceGrid Puzzle Tools is open source, so you can use and self-host it for free.

How do I add PlayBalanceGrid Puzzle Tools to Claude Code?

Run this command in your terminal: claude mcp add puzzle-tools -- npx -y playbalancegrid-mcp-server

What are the best alternatives to PlayBalanceGrid Puzzle Tools?

The closest alternatives to PlayBalanceGrid Puzzle Tools are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vectoroids.

Alternatives to PlayBalanceGrid Puzzle Tools

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. Vectoroids

    MCP server

    A first-person 3D asteroids game with a scanner, playable by humans and agents

    • 6 tools
    • Remote
    • Free
    • Games and play
  5. Vector Abyss

    MCP server

    Play a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory