# mcp

Connects coding assistants to Vidalytics via MCP to manage video players, draft settings, and view retention metrics without manual API keys.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: vidalytics
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vidalytics/vidalytics-mcp
- Updated: 2026-10-01
- HTML: https://affpapa.org/en/nevibecode/mcp/vidalytics-mcp

## What it does

This MCP server communicates with `https://api.vidalytics.com/public/v1/mcp` over HTTP. On the initial request, it prompts an OAuth authorization flow in your default browser. Once connected, your assistant can inspect video folders, fetch embed snippets, adjust playback options, and trigger remote file uploads.

Analytics queries require executing `set_user_context` before other tools will respond. The server reports audience drop-off percentages, conversion metrics, live viewer figures, and batch stats for up to 30 videos. Most write actions modify draft records first: updates to thumbnails, chapters, tags, or action overlays remain private until you trigger `publish_video`.

Read-only connections fail on write operations with a `SCOPE_INSUFFICIENT` response. When adjusting playback parameters, passing the `dryRun` flag to `update_video_settings` provides a before-and-after diff without saving changes.

## Requirements
- Remote server: `https://api.vidalytics.com/public/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.vidalytics.com/public/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add vidalytics-mcp --url https://api.vidalytics.com/public/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vidalytics-mcp": {
            "url": "https://api.vidalytics.com/public/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vidalytics-mcp": {
            "type": "http",
            "url": "https://api.vidalytics.com/public/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http vidalytics-mcp https://api.vidalytics.com/public/v1/mcp
```

## When to use it
- retrieve viewer retention curves and conversion data across assets
- update video chapters, subtitle tracks, and custom tags in draft mode
- create and position call-to-action overlays or pause screens
- generate signed direct upload URLs or fetch videos from remote links

## Example prompts
- Get dropoff retention metrics and conversion counts for video vid_123.
- Preview changes to player controls using update_video_settings with dryRun.
- Save new chapter markers to the draft and push them live with publish_video.

## Similar
- [Panda Video](https://affpapa.org/en/nevibecode/mcp/panda-video.md) — MCP server
- [YouTube Automation](https://affpapa.org/en/nevibecode/skills/youtube-automation.md) — skill · 5200 installs
- [ad-account-diagnostic](https://affpapa.org/en/nevibecode/skills/ad-account-diagnostic.md) — skill · 20600 installs
- [devrel-analytics](https://affpapa.org/en/nevibecode/skills/devrel-analytics.md) — skill · 10400 installs
- [sent-analytics](https://affpapa.org/en/nevibecode/skills/sent-analytics.md) — skill · 2900 installs
- [content-pattern-analyzer-sms](https://affpapa.org/en/nevibecode/skills/content-pattern-analyzer-sms.md) — skill · 1800 installs

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12111
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2768
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1350
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md