# Tellscreen

> Tellscreen is a freemium MCP server for developer tools. Turn a screen recording or video link into a numbered change list with screenshots. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $6 a month
- **Platforms:** Web, macOS, Windows, Chrome extension, CLI
- **Website:** https://tellscreen.com
- **MCP Registry name:** com.tellscreen/tellscreen
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

Tellscreen starts from a simple observation: a video file tells a coding agent very little, while a list of changes tells it what to do. You record your screen, point at what is wrong and say what you want, such as a button label or a price cut off on mobile. The service reads your words beside frames of your screen and writes a numbered list. Each entry has what to change, where, your exact words, how to check it is done, and a screenshot of that moment.

The list is meant to be pasted into Claude Code, Codex or Cursor, or you can record from inside Claude Code and have it land in your prompt box. Screenshots are links the agent can open. A Chrome extension lets you draw on the page while talking, and a Mac and Windows app records the whole screen with Alt+Shift+R. Existing videos such as Loom downloads or QuickTime files can be uploaded too.

Each video also gets a share link, transcript, summary and MP4 download. Videos stay on Tellscreen's own server.

## Features

- **Change list from speech:** Writes numbered changes with your words, location, a check for done and a screenshot.
- **Record from the terminal:** Adds a record button to Claude Code and a skill to Codex.
- **Draw while recording:** The Chrome extension lets you annotate the page as you talk.
- **Share link and transcript:** Each video gets a link, timed transcript, summary and MP4.
- **Upload existing videos:** Accepts Loom downloads, QuickTime recordings and other video files.

## Good for

- Report UI bugs to a coding agent by talking through them
- Hand a developer a screenshot-backed list of design tweaks
- Convert a recorded walkthrough into actionable tasks
- Share a quick screen recording with a transcript

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tellscreen https://tellscreen.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://tellscreen.com/mcp
```

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

```json
{
  "mcpServers": {
    "tellscreen": {
      "url": "https://tellscreen.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "tellscreen": {
      "type": "http",
      "url": "https://tellscreen.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tellscreen": {
      "serverUrl": "https://tellscreen.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tellscreen": {
      "type": "http",
      "url": "https://tellscreen.com/mcp"
    }
  }
}
```

## FAQ

### What does it cost?

Free covers 25 videos up to 10 minutes and 5 change lists a month. Pro is $8 a month or $72 a year.

### Do I need an account?

The site says free to start with no account.

### Which coding tools does it work with?

Claude Code, Codex and Cursor.

### Where are videos stored?

On Tellscreen's own server.

### Is Tellscreen free?

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

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

Run this command in your terminal: claude mcp add --transport http tellscreen https://tellscreen.com/mcp

### What are the best alternatives to Tellscreen?

The closest alternatives to Tellscreen 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

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