<p align="center"><img src="assets/logo.png" alt="Scrollsnacks" width="96"></p>

# Scrollsnacks MCP server and agent skills

[Scrollsnacks](https://scrollsnacks.com) is a curated library of real launch videos from products and studios. Each video is split into timed sections (hook, problem, feature, proof, CTA), so you can study and reuse what works when you plan your own launch video.

This repo is the public home of the hosted Scrollsnacks MCP server. It holds docs, the registry `server.json` and a few agent skills. There is no server code here; the server runs at:

```
https://scrollsnacks.com/mcp
```

Streamable HTTP, OAuth 2.1 with dynamic client registration, scope `library:read`. You sign in with your Scrollsnacks account the first time your client connects.

Scrollsnacks helps you plan and script. It does not make, generate or render video. Every video in the library belongs to its brand (and studio, where we can confirm it).

## Install

**Claude (web and desktop):** Settings > Connectors > Add custom connector, paste `https://scrollsnacks.com/mcp`, then sign in.

**Claude Code:**

```bash
claude mcp add --transport http scrollsnacks https://scrollsnacks.com/mcp
```

Or install this repo as a Claude Code plugin to get the server and the skills together (see `.claude-plugin/plugin.json` and `.mcp.json`).

**Cursor:** add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project):

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

**VS Code (Copilot agent mode):** add to `.vscode/mcp.json`:

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

**ChatGPT:** custom remote MCP connectors work through developer mode (Settings > Apps & Connectors > Advanced settings > Developer mode), where available on your plan. Create a connector with `https://scrollsnacks.com/mcp` and OAuth.

## Tools

Some tools and fields are only available on the Pro plan; the tool descriptions say which.

| Tool | What it does |
|---|---|
| `search_videos` | Find launch videos by text, category, style tag, brand or studio. Start here to pick a reference. |
| `get_video` | One video by id: metadata and timed sections. `view: 'blueprint'` gives beats with durations, words per second and category norms. |
| `search_sections` | Find sections across videos (CTAs, proof, feature demos) by type, effect, technique, text, category, brand or duration. |
| `get_section_media` | One section in detail: motion strip image, transcript, on-screen text, optional short MP4. |
| `search_hooks` | Opening hooks grouped by formula, with category medians for hook length and pace. |
| `get_benchmarks` | Planning norms for a category: median duration, hook length, when the product is named, CTA position, section shares. |
| `list_section_types` | The filter vocabulary: section types, effect labels and style tags. |
| `create_stitch` | Make a stitch: your ordered list of beats from real sections plus your own shots, with a build note per beat. |
| `get_stitch` | Read a stitch, or get it as a production shot list or build prompt. |
| `update_stitch` | Change your stitch: title, aspect, visibility or beats. |
| `add_comment` | Add, edit or delete a note pinned to a beat, a moment or a spot in your stitch. |
| `list_stitches` | Your stitches, newest first. |
| `delete_stitch` | Permanently delete one of your stitches. |

The server also offers the prompts `remake_video`, `find_examples` and `audit_script`.

## Example prompts

- "Show me 5 strong hooks from developer tool launch videos."
- "Break down how a fintech launch video handles its proof section."
- "Find launch videos whose CTA comes in the last 5 seconds."
- "Write a 45 second script for my habit tracker, based on 3 similar launches."

## Skills

The `skills/` folder has Agent Skills (`SKILL.md` with YAML frontmatter) that use the tools above. Copy a folder into your client's skills directory (for example `~/.claude/skills/` or `.cursor/skills/`), or install the repo as a Claude Code plugin.

| Skill | Use it to |
|---|---|
| [launch-video-script](skills/launch-video-script/SKILL.md) | Write a timed script and shot list from 3 to 5 matching launches. |
| [launch-video-teardown](skills/launch-video-teardown/SKILL.md) | Break down one launch section by section. |
| [hook-finder](skills/hook-finder/SKILL.md) | Find strong hooks for a category and draft yours. |
| [storyboard-from-formats](skills/storyboard-from-formats/SKILL.md) | Turn a chosen format into a storyboard with a stitch. |
| [cta-check](skills/cta-check/SKILL.md) | Check that your script ends with one clear ask. |

## Privacy, terms and support

- Privacy: https://scrollsnacks.com/privacy
- Terms: https://scrollsnacks.com/terms
- Support: hello@scrollsnacks.com

Skills and docs in this repo are MIT licensed. Launch videos belong to their brands and studios.