# Reaction Time Test MCP Server

> Reaction Time Test - How Fast Are Your Reflexes?

[![MCP Badge](https://lobehub.com/badge/mcp/rocnubie-reactiontimetest-mcp)](https://lobehub.com/mcp/rocnubie-reactiontimetest-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![Stdio Transport](https://img.shields.io/badge/transport-stdio-6e6e6e)](https://modelcontextprotocol.io/specification)
[![Read Only](https://img.shields.io/badge/server-read--only-2ea44f)](#tools)
[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)

A Model Context Protocol server that exposes the canonical Reaction Time Test knowledge surface — browser tests, measurement rules, and score interpretation, FAQ, official links — to MCP-compatible AI clients such as Claude Desktop, Cursor, Windsurf, and Continue. Read-only, no API keys, no quota, ~50 ms cold start.

Official website: https://reactiontimetest.click

## ⏱️ About Reaction Time Test

Reaction Time Test is a free browser test built around five rounds of waiting for green and tapping as quickly as possible. It reports average milliseconds, rank context, a daily streak, and a shareable result card without requiring an account.

The site also offers click speed, aim, memory, number memory, and typing tests. Scores and streaks stay in browser localStorage, and the application has no server endpoint for test results. This MCP explains the test catalog and measurement rules as read-only context; it cannot run a test or measure the user's reflexes.

Use the live test for an actual result. A browser reaction score is a lightweight game metric, not a medical diagnosis or a guarantee of performance in another setting.

## Tools

### `get_test_overview`
Return the test catalog and documented measurement or scoring rules exposed by the site. (Reaction Time Test)

_Input:_ no parameters. _Returns:_ text/markdown.

### `get_official_links`
Return the canonical list of official links for Reaction Time Test (website, support, docs when available).

_Input:_ no parameters. _Returns:_ text/markdown.

## Resources

- `site://reactiontimetest/tests` — Public test catalog, measurement workflow, and score-interpretation boundaries.
- `site://reactiontimetest/faq` — Short FAQ generated from public site metadata.
- `site://reactiontimetest/links` — Canonical URLs to share with users.

## Prompts

### `tell_me_about_reactiontimetest`
Summarize what the site is, who it's for, and how it works. — Reaction Time Test

### `run_a_test_reactiontimetest`
Prepare for a browser test and interpret its result conservatively. — Reaction Time Test

## Installation

### Install via Smithery

```bash
npx -y @smithery/cli install reactiontimetest-mcp --client claude
```

(Replace `claude` with `cursor`, `windsurf`, or `continue` for those clients.)

### Install from source

```bash
git clone https://github.com/rocnubie/reactiontimetest-mcp.git
cd reactiontimetest-mcp
pnpm install
```

Then add to your MCP client config (`claude_desktop_config.json` for Claude Desktop, `mcp.json` for Cursor / Windsurf / Continue):

```json
{
  "mcpServers": {
    "reactiontimetest-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/reactiontimetest-mcp/src/index.mjs"
      ]
    }
  }
}
```

### Debug with MCP Inspector

```bash
npx @modelcontextprotocol/inspector node src/index.mjs
```

## Official Links

- Website: https://reactiontimetest.click

## Development

```bash
pnpm install
pnpm start                 # run the server over stdio
```

## License

MIT