# Keyboardino MCP app

Test your keyboard, check key codes and plan a build.

Ask for a live keyboard tester, a timed typing test or the code a key reports, compare keyboard layouts, find switches by feel and force, or plan a keyboard build. The app uses the same tools and data as keyboardino.com.

- Website: https://keyboardino.com
- Documentation: https://keyboardino.com/app
- Privacy: https://keyboardino.com/privacy
- Terms: https://keyboardino.com/terms

This repository documents the hosted connector. It does not contain the
website or its code.

## Connect

- Endpoint: `https://keyboardino.com/api/mcp`
- Transport: Streamable HTTP
- Authentication: none (no account, sign-in or API key)

```json
{ "mcpServers": { "keyboardino": { "url": "https://keyboardino.com/api/mcp" } } }
```

In ChatGPT, add it as a custom MCP server with no authentication. In
Claude, open Customize, then Connectors, choose Add custom connector and enter the URL.

## Tools

All tools are read-only.

| Tool | What it does |
|---|---|
| `open_keyboard_tester` | Opens a keyboard tester for a board layout such as ANSI US or ISO UK. Each key lights up when the keyboard registers it, and the tester counts the keys received. |
| `start_typing_test` | Starts a timed typing test of 30, 60 or 120 seconds and returns its words from the website's English word list. |
| `get_keycode` | Returns the values a key reports in a browser key event: key, code, keyCode, which and location. |
| `check_rollover` | Opens a rollover test that shows the keys held down at once and the largest number of keys the keyboard registered together. |
| `get_layout` | Returns the key map of a keyboard layout with plain, Shift and AltGr characters, and the website's notes on it. |
| `compare_layouts` | Compares two keyboard layouts and returns the keys that type different characters. |
| `find_switches` | Finds keyboard switches in the website's catalog by feel, actuation force and sound recordings, and returns their specifications. |
| `plan_keyboard_build` | Plans a keyboard build from the website's reviewed combinations of barebones kit, switches and keycaps. |

## Try asking

- "Open a keyboard tester for an ISO UK keyboard."
- "Start a 60-second typing test."
- "Plan a 75% keyboard build with tactile switches."

## Report an issue

Open an issue in this repository or email abishop1933@gmail.com.

## License

The documentation files in this repository are MIT licensed (see
[LICENSE](LICENSE)). The Keyboardino website, its content, data and brand are
not covered by this license.