mcp · vidalytics — Claude Code MCP server: what it does, how to install
Connects coding assistants to Vidalytics via MCP to manage video players, draft settings, and view retention metrics without manual API keys.
claude mcp add --transport http mcp https://api.vidalytics.com/public/v1/mcpWhat mcp 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.
What it helps with
- 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 for the agent
- 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.
How to install mcp
Platform CLI: remote server
claude mcp add --transport http mcp https://api.vidalytics.com/public/v1/mcpPlatform CLI: remote server
codex mcp add vidalytics-mcp --url https://api.vidalytics.com/public/v1/mcpConfig file
{
"mcpServers": {
"vidalytics-mcp": {
"url": "https://api.vidalytics.com/public/v1/mcp"
}
}
}Config file
{
"servers": {
"vidalytics-mcp": {
"type": "http",
"url": "https://api.vidalytics.com/public/v1/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http vidalytics-mcp https://api.vidalytics.com/public/v1/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How to install mcp in Claude Code?
Add the endpoint using claude mcp add --transport http mcp https://api.vidalytics.com/public/v1/mcp. Next, complete the OAuth approval in the browser window displayed on your first request.
Why does set_user_context need to run first?
The service requires running set_user_context before executing other tools to activate account-level analytics features.
How do draft updates go live on the video player?
Write tools keep modifications in draft status. You must call publish_video to push those pending edits to the live player.
Similar MCP servers
All MCP servers for Marketing and content →mcp by other authors comes first.
