ThinkRun

ThinkRun

Records browser sessions and provides structured context (clicks, console, network, screenshots) for AI coding agents to understand and act upon.

Category
Visit Server

README

ThinkRun — Screen Recorder for AI Coding Agents

Stop screenshotting bugs and typing paragraphs to explain them. ThinkRun records any browser session — or lets your agent record what it built — and turns it into structured context your AI coding agent can act on: every click, the console, network requests, your voice narration, and screenshots, all time-synced. Not just a screenshot. Not just a video.

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

Install

npx @thinkrun/mcp

Or install the CLI globally:

npm install -g @thinkrun/cli

The CLI automatically installs the native host binary, which lets AI tools control Chrome.

Add to your MCP config

{
  "mcpServers": {
    "thinkrun": {
      "command": "npx",
      "args": ["@thinkrun/mcp"]
    }
  }
}

Config location:

  • Claude Code: ~/.claude/settings.json
  • Cursor: .cursor/mcp.json
  • Cline: VS Code settings → Cline MCP Servers

Then ask your agent: "navigate to localhost:3000 and screenshot the checkout page" — or record the bug yourself and hand the agent the result.

Why ThinkRun

Other tools give your agent eyes. ThinkRun gives it structured sight — context it can parse in one pass instead of you re-explaining the page.

ThinkRun Playwright MCP
Records a session into structured, replayable context ✅ ❌ drive-only
Turns a recording into an AI-ready report (clicks, console, network) ✅ ❌
Shareable link, also as LLM-ready Markdown / JSON ✅ ❌
Uses your real Chrome — your cookies & sessions ✅ ❌ headless only
Runs alongside your browser, no profile conflict ✅ ❌ fights for Chrome profile

Agent skills for Claude Code, Cursor, Codex & Gemini CLI

Four portable agent skills ship in this repo, mirrored for every major harness (.claude/skills/, .cursor/skills/, .codex/skills/, .gemini/skills/):

  • web-browse — browse the web programmatically: drive a real or cloud browser to navigate, interact, extract, and screenshot.
  • ux-audit — walk through a product UI as a real user, screenshot every step, and produce a structured UX report with a prioritized fix list.
  • thinkbrowse-cli — drive the browser from shell scripts via the thinkrun CLI.
  • thinkbrowse-mcp — drive the browser through the ThinkRun MCP server's tools.

Install without cloning — the repo is served as a live MCP server that auto-updates on every commit:

{ "mcpServers": { "thinkrun-skills": { "url": "https://mcp.skillsovermcp.com/mcp/dundas/thinkrun" } } }

Trigger accuracy is measured, not claimed. Every skill ships a 20-query trigger-eval fixture, and evals/BENCHMARK.md publishes the results: 79–80/80 routing accuracy on 12 of the 16 published model configurations (GPT-5.4/5.5/5.6 and Claude Sonnet/Opus/Fable families; the outliers are a documented strict-reading mode, not crashes), plus catalog-ablation runs showing the skills absorb each other's traffic when installed as a subset. Reproduce with bun evals/run-eval.ts build.

Manual binary install

If you need to install the native host without the CLI, download the binary for your platform from the latest release and run:

chmod +x thinkbrowse-host-* && ./thinkbrowse-host-* --install

The native host binary keeps the thinkbrowse-host filename for now — it's the same signed binary, unchanged by the rename.

FAQ

How do I give Claude Code (or Cursor) access to my browser?

Add ThinkRun as an MCP server — npx @thinkrun/mcp — and your agent can drive and read a real Chrome session, your cookies and logins included. See "Add to your MCP config" above.

How do I show Cursor a UI bug instead of pasting a screenshot?

Record the bug with ThinkRun. Instead of a flat image, your agent gets a structured artifact — the steps you took, the console errors, the failing network requests, and the DOM state at the moment it broke — so it fixes the actual problem instead of guessing from a picture.

Is there an MCP server that uses my real Chrome cookies and sessions?

Yes. ThinkRun runs against your real Chrome via a native host, so authenticated pages just work — no headless re-login, no separate profile, no fighting your browser for the Chrome profile.

How do I record a browser session for an AI coding agent?

Run npx @thinkrun/mcp (or npm i -g @thinkrun/cli) and record any session — or let the agent record what it built. ThinkRun turns it into an AI-ready report (clicks, console, network, narration, screenshots, all time-synced), available as a shareable link and as LLM-ready Markdown/JSON.

How do I give my AI coding agent context about what went wrong?

Hand it a ThinkRun recording. The structured "what happened" — actions, first bad signal, expected vs actual, and the element state — is exactly the context an agent needs to land a fix on the first try.

More

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured