HLPlanet Keyboard Sizes

Compare keyboard sizes (100%, TKL, 75%, 65%, 60%) and 30 real keyboards, check desk and mousepad fit, find which sizes have a key, and search HLPlanet keyboard reviews.

GitHub

Documentation

HLPlanet MCP: keyboard sizes, dimensions and desk fit

An MCP server that lets AI assistants answer keyboard size questions with real data:

Compare full-size, 98%, TKL, 75%, 65% and 60% layouts: size difference, missing keys, extra mouse room
Look up the measured dimensions of 30 keyboards reviewed on HLPlanet
Check whether a keyboard and mousepad fit on your desk, including a full 360° turn at your sensitivity
Find out which sizes have a key (Delete, F5, Insert, arrows, numpad...)
Search HLPlanet reviews of Hall effect, TMR and rapid trigger keyboards and gaming controllers

The data matches the interactive keyboard size comparison on HLPlanet, and every answer links to it so you can see the layouts to scale.

"Will a TKL and my 45 cm mousepad fit on a 120 cm desk?" "How much smaller is a 75% than a TKL, and what keys do I lose?" "How wide is the MCHOSE Jet 75 compared to the Wooting 80HE?" "Which keyboard sizes still have a Delete key?"

Install

No API key or account needed. Requires Node.js 18 or newer.

Claude Desktop: download hlplanet-mcp.mcpb from the latest release and double-click it. Or add this to claude_desktop_config.json:

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

Claude Code

claude mcp add hlplanet -- npx -y hlplanet-mcp

Cursor: add the same mcpServers block as above to ~/.cursor/mcp.json.

VS Code

code --add-mcp "{\"name\":\"hlplanet\",\"command\":\"npx\",\"args\":[\"-y\",\"hlplanet-mcp\"]}"

Streamable HTTP: npx -y hlplanet-mcp --http serves the MCP endpoint at http://localhost:3000/mcp (set PORT to change it).

Tools

Tool	What it does
`list_keyboard_sizes`	Every standard size with key count, typical dimensions, missing keys and who it suits
`compare_keyboards`	Compare 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`	Keyboard + mousepad on your desk: room left, pad overhang, distance from screen centre, 360° turn fit
`which_sizes_have_key`	Which sizes have a key or key group, and which need an Fn layer
`search_hlplanet`	Search HLPlanet.com reviews, comparisons and guides
`list_testing_tools`	Links to HLPlanet's free keyboard, gamepad and reaction time testers

All tools are read-only. search_hlplanet is the only one that uses the internet (the HLPlanet.com search API); everything else runs offline.

About the data

Standard sizes use the 19.05 mm key spacing plus an estimated 10 mm case border. Layouts follow the most common arrangement of each size; some brands move a few keys.
Real keyboards use the case dimensions measured in each HLPlanet review.
The desk check places the keyboard with its B key in front of the screen centre and leaves 3 cm between keyboard and mousepad, the same as the desk planner on the website.

Development

npm install
npm test        # builds dist/index.js and runs the end-to-end tests over stdio and HTTP
npm run mcpb    # builds hlplanet-mcp.mcpb for Claude Desktop