Watch Cli

Name: Watch Cli
Author: sonpiaz

by sonpiazcommunityv0.3.1

248

An MCP stdio server that exposes the `watch-cli` command as a single `watch` tool for MCP-capable agents. The tool takes a social video URL and optional frame count, then returns the JSON output produced by `watch-cli`.

From the registry: Hand any social video to your AI agent — frames + transcript bundled. MCP server for watch-cli.

GitHub Repository

Install & configure

Prerequisites

required
Install Node.js
Node.js 18 or newer is required to run the MCP server via npm/npx.
required
Install watch CLI
The MCP server shells out to the `watch` CLI, which must be installed and available on PATH.
```
$ curl -fsSL https://raw.githubusercontent.com/sonpiaz/watch-cli/main/install.sh | bash
```
https://github.com/sonpiaz/watch-cli

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `watch-cli` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install Node.js** — Node.js 18 or newer is required to run the MCP server via npm/npx.
- **Install watch CLI** — The MCP server shells out to the `watch` CLI, which must be installed and available on PATH. Run: `curl -fsSL https://raw.githubusercontent.com/sonpiaz/watch-cli/main/install.sh | bash` (https://github.com/sonpiaz/watch-cli)

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@sonpiaz/watch-cli-mcp"]

Note: Prefer the on-demand npx install path. The server communicates over stdio, reading JSON-RPC from stdin, writing JSON-RPC to stdout, and logging to stderr.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Prefer the on-demand npx install path. The server communicates over stdio, reading JSON-RPC from stdin, writing JSON-RPC to stdout, and logging to stderr.

Tools (1)

watch

Runs `watch-cli` on a social video URL and returns its v1 JSON output; supports an optional `frames` parameter to control how many frames are extracted.