# HLPlanet Keyboard Sizes

> HLPlanet Keyboard Sizes is a free MCP server for games and play. Compare keyboard sizes, check desk and mousepad fit, search HLPlanet reviews. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, API
- **Website:** https://www.hlplanet.com/keyboard-layout/
- **Repository:** https://github.com/hlplanet/hlplanet-mcp
- **MCP Registry name:** io.github.hlplanet/hlplanet-mcp
- **Categories:** games and play
- **Listing updated:** 2026-11-15

## About

Keyboard photos hide scale, and this server answers the practical questions instead: how much narrower a 75% board is than a TKL, which keys you lose, and whether a keyboard and mousepad fit on a 120 cm desk with room for a full 360-degree mouse turn.

The layout maths uses the 19.05 mm key spacing plus an estimated 10 mm case border, and measured case sizes for 30 reviewed keyboards come from HLPlanet's own reviews. The desk check puts the B key in front of the screen centre and leaves 3 cm between keyboard and pad. All tools are read-only and run offline except the review search, which calls the HLPlanet.com search API.

No API key or account is needed. Run it with npx, install the .mcpb bundle in Claude Desktop, or connect to the hosted endpoint at api.hlplanet.com/mcp.

## Features

- **Size comparison:** Compare 2-6 layouts or real keyboards by width, depth, keys lost and mouse room.
- **Desk and pad fit:** Check room left, pad overhang and whether a 360-degree turn fits.
- **Key lookup:** Find which sizes have a given key such as Delete, F5 or arrows.
- **Measured dimensions:** Case sizes of 30 reviewed keyboards, searchable by name or size.
- **Review search:** Search HLPlanet reviews of Hall effect, TMR and rapid trigger keyboards and controllers.

## Good for

- Decide between TKL, 75% and 65% for a small desk
- Work out whether a large mousepad fits beside a keyboard
- Check which compact layouts keep an F-row or arrow keys
- Compare the footprint of two specific reviewed keyboards

## Install

### Claude Code (Terminal)

```sh
claude mcp add hlplanet-mcp -- npx -y hlplanet-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hlplanet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hlplanet-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hlplanet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hlplanet-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "hlplanet-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hlplanet-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hlplanet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hlplanet-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hlplanet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hlplanet-mcp"
      ]
    }
  }
}
```

## Tools

- `list_keyboard_sizes`: Every standard size with key count, typical dimensions, missing keys and who it suits.
- `compare_keyboards`: Compares 2-6 sizes or real keyboards: width, depth, keys lost or gained, mouse room.
- `get_keyboard_dimensions`: Measured case size of reviewed keyboards, searchable by name or size.
- `check_desk_fit`: Checks a keyboard plus mousepad on your desk: room left, overhang, distance from screen centre, 360 degree turn fit.
- `which_sizes_have_key`: Shows which sizes have a key or key group and which need an Fn layer.
- `search_hlplanet`: Searches HLPlanet.com reviews, comparisons and guides.
- `list_testing_tools`: Links to HLPlanet's keyboard, gamepad and reaction time testers.

## FAQ

### Does it need an API key?

No. The README says no key or account is needed.

### Which tool goes online?

Only search_hlplanet; the others run offline.

### What Node.js version is required locally?

Node.js 18 or newer.

### Are the sizes exact?

Standard sizes are estimates with an assumed 10 mm border, so real boards can differ by a few millimetres.

### Is HLPlanet Keyboard Sizes free?

Yes. HLPlanet Keyboard Sizes is free to use.

### How do I add HLPlanet Keyboard Sizes to Claude Code?

Run this command in your terminal: claude mcp add hlplanet-mcp -- npx -y hlplanet-mcp

### What are the best alternatives to HLPlanet Keyboard Sizes?

The closest alternatives to HLPlanet Keyboard Sizes 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/hlplanet-keyboard-sizes
