MCP tools reference

beta

The stdio MCP server agent-video mcp exposes — upload, list, and show — and every argument each tool takes.

Examples

$ upload { path: "session.mp4", title: "Sprint demo", tags: ["demo"] }

Upload a local video file; chunked + resumable, safe to retry

$ list { limit: 10 }

List the 10 most recent videos

$ show { id: "abc123" }

Fetch one video's full metadata, including its share URL

MCP tools reference

agent-video install wires the right entry for you (see the CLI reference). This page is the lookup catalog for exactly which tools the server exposes and what each one takes.

Server — agent-video mcp

The CLI runs a local (stdio) MCP server. It's the entry agent-video install writes into ./.mcp.json. There's no token in the config — auth comes from your agent-video login (or AGENT_VIDEO_TOKEN in the environment, resolved exactly like every CLI command).

agent-video mcp

Terminal progress output is suppressed for this server (a silent progress reporter) — the upload tool shares its implementation with the CLI's upload command, but must never write carriage-return control sequences into the stdio JSON-RPC stream.

Tools

upload

Uploads a local video file. Chunked (8 MiB) and resumable — safe to retry the same call on failure; a retried call with the same file resumes from the last chunk the server actually received rather than re-sending the whole file.

ArgumentTypeRequiredDescription
pathstringyesAbsolute or relative path to the local video file.
titlestringnoVideo title (defaults to the file name).
descriptionstringnoVideo description.
privacystringnopublic | unlisted | password | private (default unlisted).
passwordstringnoRequired when privacy is password.
tagsstring[]noTags to attach to the video.

Returns { id, title, status, url? }.

list

Lists your videos, newest first.

ArgumentTypeRequiredDescription
limitintnoCap the number of videos returned.

Returns { videos: Video[] }.

show

Shows one video's full metadata: title, description, privacy, status, duration, tags, chapters, view count, and its share URL.

ArgumentTypeRequiredDescription
idstringyesThe video id.

Returns { video: Video }.

Resources

This server exposes no MCP resources — every tool returns its result inline in the tool-call response.

See also