Skip to content
MCP server

HLPlanet Keyboard Sizes

Compare keyboard sizes, check desk and mousepad fit, search HLPlanet reviews

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, API
Runs
Locally
Version
1.0.0
Listing updated
2 days ago

About HLPlanet Keyboard Sizes

HLPlanet Keyboard Sizes is a free MCP server for games and play. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hlplanet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hlplanet-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hlplanet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hlplanet-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

No key or account needed

Prices change. Check hlplanet.com before you buy.

HLPlanet Keyboard Sizes 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 to HLPlanet Keyboard Sizes

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. Vectoroids

    MCP server

    A first-person 3D asteroids game with a scanner, playable by humans and agents

    • 6 tools
    • Remote
    • Free
    • Games and play
  5. Vector Abyss

    MCP server

    Play a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory