Skip to content
MCP server

Tourwright

Turn a YAML script into a narrated product tour video with captions and an MP4

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
2.6.2
Listing updated
today

Similar MCP servers

About Tourwright

Tourwright is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • TOURWRIGHT_API_URLSend jobs to a Tourwright API instead of rendering on this machine
  • TOURWRIGHT_API_TOKENToken for TOURWRIGHT_API_URL

What it does

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

Pricing

Open source

Free, MIT licence

Tourwright 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.

How AIPoweredBot checks servers