# GenClass

> GenClass is a freemium MCP server for developer tools. Replay reordered responses to find race conditions in a web app, then prove the fix. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $15 a month
- **Platforms:** CLI, self-hosted
- **Website:** https://genclass.dev
- **Repository:** https://github.com/genclass-dev/genclass/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.genclass-dev/genclass
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Bugs like a stale search result overwriting a newer one, or an order submitted twice by two clicks, never throw an error, so monitoring tools miss them. This stdio server connects a coding agent to the pages of your app running locally and shows what happened in order: every click, request and response, the order responses arrived, and what each one wrote into the app's state.

The agent can then rerun the same steps with the network answering in a different order, report what ends differently, and replay the exact order that caused a bug before and after a fix. It can also write a Playwright test that fails while the bug exists. By default everything stays on your machine, and the README says the package has no dependencies.

The server belongs to the wider GenClass product, whose open-source runtime (Apache-2.0) and MCP server are free. A paid Pro plan at $15 per developer adds the genclass command, a dashboard of every problem and a GitHub App for private repositories.

## Features

- **Causal event timeline:** Shows each click, request and response in order, with the state each response wrote.
- **Silent bug detection:** Flags stale overwrites, duplicate submits and detections from an on-device model.
- **Reordered-response exploration:** Reruns your steps with the network answering in different orders and reports what differs.
- **Exact replay:** Delivers the order that caused a bug before and after a fix to show reproduced or not.
- **Failing test generation:** Writes a Playwright test that fails while the bug is present.
- **Local by default:** Data stays on your machine unless you opt into the hosted service.
- **Many client installs:** Install blocks for Claude Code, Claude Desktop, Cursor and VS Code.

## Good for

- Debug a search box that sometimes shows old results
- Find double-submit bugs that create duplicate orders
- Confirm a race-condition fix with a replay before and after
- Generate a regression test for a lost-edit bug
- Review Playwright test runs for races on pull requests

## Install

### Claude Code (Terminal)

```sh
claude mcp add genclass -- npx -y @genclass/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "genclass": {
      "command": "npx",
      "args": [
        "-y",
        "@genclass/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "genclass": {
      "command": "npx",
      "args": [
        "-y",
        "@genclass/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "genclass": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@genclass/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "genclass": {
      "command": "npx",
      "args": [
        "-y",
        "@genclass/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "genclass": {
      "command": "npx",
      "args": [
        "-y",
        "@genclass/mcp"
      ]
    }
  }
}
```

## Tools

- `genclass_explore`: Reruns your steps with the network answering in different orders and reports what ends differently.
- `genclass_replay`: Delivers the exact response order that produced a bug, before and after a fix.
- `genclass_explain`: Gives the evidence in causal order and writes a Playwright test that fails while the bug is present.
- `genclass_setup`: Prints the install block for the client it runs in.

## FAQ

### Does it run in the cloud?

No. By default it runs against your app on your machine and data stays there. A hosted version is offered only under the Enterprise plan.

### How is it installed?

Through npx with the @genclass/mcp package, or as a Claude Code plugin. Config blocks are given for Claude Desktop, Cursor and VS Code.

### Is it free?

The MCP server and Apache-2.0 runtime are free. Pro costs $15 per developer per month with a 3-day trial.

### Which tools does the agent get?

The README names genclass_explore, genclass_replay, genclass_explain and genclass_setup.

### Is GenClass free?

GenClass has a free plan, with paid plans for more usage or features. Paid plans start at $15 a month.

### How do I add GenClass to Claude Code?

Run this command in your terminal: claude mcp add genclass -- npx -y @genclass/mcp

### What are the best alternatives to GenClass?

The closest alternatives to GenClass are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/genclass
