# Thinkrun

> Thinkrun is a freemium MCP server for browser automation. Local MCP server for browser control and session recording for coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Chrome extension, Web, macOS, Linux
- **Website:** https://thinkrun.ai
- **Repository:** https://github.com/dundas/thinkrun
- **MCP Registry name:** io.github.dundas/thinkrun
- **Categories:** browser automation, developer tools
- **Listing updated:** 2026-11-14

## About

Thinkrun records a browser session, covering screen, voice, clicks, console and network, time-synced into a structured report an agent can read in one pass instead of re-reading a page dump. The README contrasts this with drive-only tools such as Playwright MCP: it uses your real Chrome with its existing cookies and sessions, and runs alongside your browser without a profile conflict.

Install is npx @thinkrun/mcp, with a CLI that adds a native host binary so tools can control Chrome. Control is scoped to tabs you attach, commands are policy-checked and a kill switch is always on. Passwords are masked at capture and auth headers scrubbed, and local mode needs no account.

The repo also ships seven portable agent skills, including prove-it, ux-audit and web-browse, for Claude Code, Cursor, Codex and Gemini CLI. The pricing page says hosted analysis limits are not yet enforced, with a Free plan of five cloud analyses and 100 credits.

## Features

- **Structured recordings:** Clicks, console, network and voice narration, time-synced.
- **Real Chrome control:** Agents drive the Chrome you are already signed into.
- **Shareable reports:** Copy a recording as Markdown or JSON for an agent.
- **Privacy controls:** Passwords masked and auth headers scrubbed before sharing.
- **Agent skills:** Seven skills such as prove-it and ux-audit.
- **Local mode:** No account or server; recordings stay on your machine.

## Good for

- Hand an agent a recorded bug with its failing request
- Pin frontend feedback to an element and moment
- Have an agent audit a user journey with screenshots
- Attach browser evidence to a code review

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### Does it need an account?

Local mode needs none; recordings stay on your machine unless shared.

### How do I install it?

Run npx @thinkrun/mcp, or install the CLI globally with npm.

### Which agents does it support?

Claude Code, Cursor, Cline, Windsurf and any MCP client.

### How does it differ from Playwright MCP?

The README says it records sessions into reports and uses your real Chrome rather than a headless browser.

### Is Thinkrun free?

Thinkrun has a free plan, with paid plans for more usage or features.

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

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

### What are the best alternatives to Thinkrun?

The closest alternatives to Thinkrun are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [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.

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