HLPlanet Keyboards & Controllers

Keyboard size and desk-fit answers from measured data, plus skills for building browser keyboard and gamepad testers.
An agent plugin for Hermes Agent, Cursor and other Agent Plugins clients, by HLPlanet, the site that tests Hall effect and TMR keyboards and controllers.

What's inside

Component	What it does
MCP server hlplanet	Connects to HLPlanet's hosted server at https://api.hlplanet.com/mcp (Streamable HTTP, no sign-in, all tools read-only): compare keyboard sizes and 30 measured keyboards, check desk and mousepad fit, find which sizes have a key, search HLPlanet reviews, list HLPlanet's free testing tools
Skill keyboard-size-advisor	Recommends a keyboard size for coding or gaming, including which editor shortcuts (F5, F10, F12...) move to an Fn layer
Skill browser-gamepad-input	Gamepad API patterns: polling, standard mapping, analog triggers, stick drift and circularity tests, built-in deadzone detection, vibration
Skill browser-keyboard-testing	Keyboard tester patterns: code vs key, keys the browser misses, rollover, chatter, rapid trigger tap tests, SOCD / Snap Tap detection
Rule browser-input-handling (Cursor only)	Short checklist of input gotchas the agent applies when it writes keyboard or gamepad code

The skills describe the techniques behind HLPlanet's free browser tools, which also work as reference implementations:

• Stick drift and gamepad tester
• Online keyboard tester with rollover, chatter, rapid trigger and SOCD tests
• Keyboard size comparison, drawn to scale
• Controller reaction time test
• Rapid Trigger & SOCD Tester for Windows and browsers (open source)

The MCP server is documented at api.hlplanet.com/docs/mcp, next to the free HLPlanet Keyboard API that serves the same data as JSON.

Install

Hermes Agent

hermes plugins install hlplanet/hlplanet-cursor-plugin
hermes plugins enable hlplanet

This is a portable Agent Plugins v1 package (plugin.json + mcp.json + skills/), configuration only. The skills load as hlplanet:keyboard-size-advisor, hlplanet:browser-gamepad-input and hlplanet:browser-keyboard-testing.

Cursor

From the marketplace: open Customize in Cursor, search for "HLPlanet" and select Install.

From this repository: clone it into your local plugins folder, then run Developer: Reload Window:

git clone https://github.com/hlplanet/hlplanet-cursor-plugin ~/.cursor/plugins/local/hlplanet

Just the MCP server

Claude Code: claude mcp add --transport http hlplanet https://api.hlplanet.com/mcp. Other clients: add {"mcpServers": {"hlplanet": {"url": "https://api.hlplanet.com/mcp"}}}. To run it locally instead, use npx -y hlplanet-mcp (hlplanet-mcp).

What it connects to

• Network: every MCP tool call goes to HLPlanet's server at api.hlplanet.com (a Cloudflare Worker, source). search_hlplanet passes the search text on to the HLPlanet site search at www.hlplanet.com. Nothing else leaves your machine.
• Accounts and credentials: none. No API key, sign-in, cookies or stored tokens.
• Local access: none. The package runs no commands, reads no files outside itself and starts no background processes.
• Data: the server keeps no logs of tool arguments and collects no telemetry.
• Approvals: the package marks the server untrusted for Hermes. Every tool is annotated read-only, so calls run without prompts.
• Privacy policy: api.hlplanet.com/privacy

Try it

"I code all day and play some Valorant. Is a 65% keyboard a bad idea?" "Will a TKL and a 45 cm mousepad fit on my 120 cm desk at 30 cm/360?" "Add a stick drift test to this controller page." "Why does my keyboard tester show keys stuck down after Alt+Tab?" "Detect whether a keyboard has SOCD / Snap Tap turned on."

License

MIT. See LICENSE.