# Spotlightr — MCP server on mcp.ai
> Connect your Spotlightr account and use 12 tools for video and audio straight from your AI agent. Connect with your own API key. Spotlightr is a video hosting and streaming platform that captures leads, updates contacts with engagement data, and provides analytics reporting.

By: mcp.ai · official
Page: https://mcp.ai/spotlightr

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_spotlightr?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/spotlightr/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/spotlightr/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/spotlightr/skill.md
Postman collection (v2.1): https://mcp.ai/spotlightr/postman.json

## Tools
- spotlightr_add_domain(domain: string) — Tool to add a whitelisted domain for embedding Spotlightr videos. Use when you need to whitelist a new domain for video embedding.
- spotlightr_create_group(name: string) — Tool to create a new project (group) in Spotlightr. Use when you need to organize videos into a new project or group.
- spotlightr_create_video(URL: string, hls?: integer, name: string, create?: integer, customS3?: string, videoGroup?: string, playerSettings?: object) — Tool to create a video in Spotlightr by uploading a file or linking from an external source. Use when you need to add a new video from YouTube, Google Drive, Vimeo, or other sources.
- spotlightr_delete_video(video_ids: integer[]) — Tool to delete or remove videos from Spotlightr projects. Use when you need to permanently delete one or more videos by their IDs.
- spotlightr_get_domains() — Tool to retrieve whitelisted domains for a Spotlightr account. Use when you need to list all domains approved for embedding videos.
- spotlightr_get_top_videos(days?: integer, total?: integer) — Tool to retrieve the top videos from a Spotlightr account. Use when you need to list the most viewed videos.
- spotlightr_get_video_metrics(video_id: string) — Tool to retrieve analytics metrics for a specified video. Use when you have a video ID and need its metrics (loads, plays, playRate, completionRate, shares, etc.).
- spotlightr_get_video_source(id: integer, URL: string) — Tool to get or replace the video source for an existing video in Spotlightr. Use when you need to update a video's source URL.
- spotlightr_get_video_views(videoID: integer, allViews?: boolean, onlyWatched?: boolean, customViewerID?: string) — Tool to retrieve video view data with optional filtering by viewer ID and watch status. Use when you need detailed view records for a specific video.
- spotlightr_list_groups() — Tool to retrieve all projects (groups) in a Spotlightr account. Use when you need to list all available projects or groups.
- spotlightr_list_videos(video_id?: integer, video_group?: integer) — Tool to retrieve videos from a Spotlightr account. Use when you need to list all videos or filter by specific video ID or project.
- spotlightr_search_global(query?: string) — Tool to perform account-wide search across all videos and content in Spotlightr. Use when you need to find specific videos, projects, or content by name or keyword.

## Example prompts
- "What can I do in Spotlightr?"
- "Show me a summary of my Spotlightr account"

## Links
Docs: https://mcp.ai/docs/mcps/spotlightr
Website: https://mcp.ai/mcps/spotlightr