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 and returns a Markdown answer plus the same data as JSON (structuredContent, described by the tool's outputSchema).

Clients that discover servers before connecting can read the server card or the domain's AI catalog.

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 (npm).

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.