For AI agents: the documentation index is at https://api.hlplanet.com/llms.txt. This page is also available as Markdown at https://api.hlplanet.com/docs/mcp.md.

HLPlanet Keyboard APIKeyboard sizesMeasured keyboardsCompare keyboardsDesk fitFind a keyTesting toolsMCP serverErrorsOpenAPI

MCP server

The API is also an MCP server, so AI assistants can answer keyboard size questions with these numbers instead of guessing.

Endpoint

https://api.hlplanet.com/mcp

Streamable HTTP transport, stateless, no sign-in or API key. Every tool is read-only.

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 measured keyboards: width, depth, keys lost or gained, mouse room
get_keyboard_dimensionsMeasured case size of keyboards reviewed on HLPlanet, by name or size
check_desk_fitKeyboard and mousepad on a desk: room left, pad overhang, 360° turn fit
which_sizes_have_keyWhich sizes have a key or key group
search_hlplanetSearch HLPlanet reviews, comparisons and guides
list_testing_toolsFree HLPlanet keyboard and controller testers

Connect

Claude Code:

claude mcp add --transport http hlplanet https://api.hlplanet.com/mcp

Cursor, VS Code and other clients that read an mcpServers file:

{
  "mcpServers": {
    "hlplanet": { "url": "https://api.hlplanet.com/mcp" }
  }
}

Hermes Agent: install the HLPlanet plugin, which connects to this server and adds a keyboard size skill:

hermes plugins install hlplanet/hlplanet-cursor-plugin

Prefer a local server? The same tools run offline with npx -y hlplanet-mcp (source).

Privacy

The server keeps no logs of tool arguments and sets no cookies. search_hlplanet sends the search text to the HLPlanet site search; every other tool answers from data built into the server.