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
| 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 measured keyboards: width, depth, keys lost or gained, mouse room |
get_keyboard_dimensions | Measured case size of keyboards reviewed on HLPlanet, by name or size |
check_desk_fit | Keyboard and mousepad on a desk: room left, pad overhang, 360° turn fit |
which_sizes_have_key | Which sizes have a key or key group |
search_hlplanet | Search HLPlanet reviews, comparisons and guides |
list_testing_tools | Free 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.