English Français العربية

HLPlanet Keyboard Sizes

Official registry Search and web

Compare keyboard sizes and 30 real keyboards, check desk and mousepad fit, search HLPlanet reviews.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package hlplanet-mcp
Claude Code 
claude mcp add hlplanet-keyboard-sizes -- npx -y hlplanet-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hlplanet-keyboard-sizes": {
            "command": "npx",
            "args": [
                "-y",
                "hlplanet-mcp@1.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. HLPlanet MCP: keyboard sizes, dimensions and desk fit
  2. Install
  3. Tools
  4. About the data
  5. More from HLPlanet
  6. Development
  7. License

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

ToolWhat it does
list_keyboard_sizesEvery standard size with key count, typical dimensions, missing keys and who it suits
compare_keyboardsCompare 2–6 sizes or real keyboards: width, depth, keys lost or gained, mouse room
get_keyboard_dimensionsMeasured case size of reviewed keyboards, searchable by name or size
check_desk_fitKeyboard + mousepad on your desk: room left, pad overhang, distance from screen centre, 360° turn fit
which_sizes_have_keyWhich sizes have a key or key group, and which need an Fn layer
search_hlplanetSearch HLPlanet.com reviews, comparisons and guides
list_testing_toolsLinks 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.

More from HLPlanet

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

License

MIT © HLPlanet

Frequently asked questions

What is HLPlanet Keyboard Sizes?

Compare keyboard sizes and 30 real keyboards, check desk and mousepad fit, search HLPlanet reviews.

How do I install HLPlanet Keyboard Sizes?

It runs on your machine. In Claude Code: claude mcp add hlplanet-keyboard-sizes -- npx -y hlplanet-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does HLPlanet Keyboard Sizes need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is HLPlanet Keyboard Sizes open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains HLPlanet Keyboard Sizes?

It is published by hlplanet. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.