PlayBalanceGrid Puzzle Tools
Generate, validate and get hints for Takuzu (Binairo) puzzles in 6x6 to 10x10 grids
- 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-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"puzzle-tools": {
"command": "npx",
"args": [
"-y",
"playbalancegrid-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"puzzle-tools": {
"command": "npx",
"args": [
"-y",
"playbalancegrid-mcp-server"
]
}
}
}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

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media
Born Then
MCP serverFree MCP server that rolls random historical births weighted by real demographics
- 2 tools
- Remote
- Free
- Education and exams
Haze City
MCP serverMCP server for agents to look around and build in a shared 3D world
- 17 tools
- Remote
- Open source
- Games and play

Vectoroids
MCP serverA first-person 3D asteroids game with a scanner, playable by humans and agents
- 6 tools
- Remote
- Free
- Games and play

Vector Abyss
MCP serverPlay a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn
- 6 tools
- Remote
- Free
- Knowledge and memory