# PlayBalanceGrid Puzzle Tools

> PlayBalanceGrid Puzzle Tools is an open-source MCP server for games and play. Generate, validate and get hints for Takuzu (Binairo) puzzles in 6x6 to 10x10 grids. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://playbalancegrid.com
- **Repository:** https://github.com/amigameow/playbalancegrid-mcp
- **MCP Registry name:** com.playbalancegrid/puzzle-tools
- **Categories:** games and play
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Vectoroids](https://ai-powered.com/mcp/vectoroids): Vectoroids is a free MCP server for games and play.
- [Vector Abyss](https://ai-powered.com/mcp/vector-abyss): Vector Abyss is a free MCP server for knowledge and memory.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/playbalancegrid-puzzle-tools
