# Tourwright

> Tourwright is an open-source MCP server for design and media. Turn a YAML script into a narrated product tour video with captions and an MP4. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted, API
- **Repository:** https://github.com/cxmiloxx/tourwright
- **MCP Registry name:** io.github.CXmiloxx/tourwright
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Tourwright films a real Chromium browser from a script and returns a finished video. A tour is a YAML file of steps (go to a page, say a line, click a button by role and name), and one render produces an H.264 MP4 with chapters, captions burned in, SRT and VTT files, a thumbnail and a JSON manifest.

Because tours are code, a `check` command can report which videos broke after a UI change and at which step, and `fix` writes new targets into the script. Variables let one script produce many videos, and a `mask` option swaps personal data on screen for invented data.

Narration can use offline voices (Pocket TTS, Piper), Microsoft Edge voices or any OpenAI-compatible TTS server. This MCP server runs over stdio from the npm package and lets an agent make tours; setting TOURWRIGHT_API_URL sends jobs to a Tourwright API instead of rendering locally. The project is MIT licensed.

## Features

- **Scripted browser tours:** Drives real Chromium with an animated cursor, highlights, zoom and callouts.
- **Multiple voice engines:** Offline Pocket TTS and Piper, Edge voices, or any OpenAI-compatible TTS server.
- **Staleness checks:** Reports which video broke after a deploy and suggests the fix.
- **Variables and masking:** One script yields many videos, with personal data replaced by invented data.
- **Full deliverables:** MP4 with chapters and captions, plus SRT, VTT, thumbnail and JSON manifest.
- **Four ways in:** CLI, HTTP API with queue and webhooks, MCP server and Node library.
- **Scales out:** Runs as one process or as API replicas with workers, Redis and S3-compatible storage.

## Good for

- Produce how-to videos for a SaaS app without screen recording
- Re-render tutorials after a UI redesign
- Make the same walkthrough for many customers or languages
- Let an AI agent generate a product demo video
- Run a CI check that flags outdated tutorial videos

## Install

### Claude Code (Terminal)

```sh
claude mcp add tourwright --env TOURWRIGHT_API_TOKEN='<TOURWRIGHT_API_TOKEN>' -- npx -y tourwright
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tourwright": {
      "command": "npx",
      "args": [
        "-y",
        "tourwright"
      ],
      "env": {
        "TOURWRIGHT_API_TOKEN": "<TOURWRIGHT_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tourwright": {
      "command": "npx",
      "args": [
        "-y",
        "tourwright"
      ],
      "env": {
        "TOURWRIGHT_API_TOKEN": "<TOURWRIGHT_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "tourwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tourwright"
      ],
      "env": {
        "TOURWRIGHT_API_TOKEN": "<TOURWRIGHT_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tourwright": {
      "command": "npx",
      "args": [
        "-y",
        "tourwright"
      ],
      "env": {
        "TOURWRIGHT_API_TOKEN": "<TOURWRIGHT_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tourwright": {
      "command": "npx",
      "args": [
        "-y",
        "tourwright"
      ],
      "env": {
        "TOURWRIGHT_API_TOKEN": "<TOURWRIGHT_API_TOKEN>"
      }
    }
  }
}
```

## FAQ

### What do I need to run it?

Node.js 22 or later on Linux, macOS or Windows; `tourwright install` fetches ffmpeg, voices and Chromium if missing. A Docker image is also available.

### Does narration need a cloud service?

No. Pocket TTS and Piper work offline, and every sentence is cached so re-rendering does not re-synthesize.

### What licence is it under?

MIT.

### Can it render on another machine?

Yes. Set TOURWRIGHT_API_URL and TOURWRIGHT_API_TOKEN to send jobs to a Tourwright API.

### Which languages can tours be translated to?

The translate command lists English, Portuguese, French, German and Italian.

### Is Tourwright free?

Yes. Tourwright is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add tourwright --env TOURWRIGHT_API_TOKEN='<TOURWRIGHT_API_TOKEN>' -- npx -y tourwright

### What are the best alternatives to Tourwright?

The closest alternatives to Tourwright are REA, HyperFrames by HeyGen, Context7, Chrome DevTools MCP and Codebase Memory.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.

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