# Spotlightr — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_spotlightr?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `spotlightr_add_domain`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/spotlightr`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/spotlightr/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/spotlightr/add/domain` — Tool to add a whitelisted domain for embedding Spotlightr videos. Use when you need to whitelist a new domain for video embedding.
  - body: { domain: string }
- `POST https://api.mcp.ai/api/spotlightr/create/group` — Tool to create a new project (group) in Spotlightr. Use when you need to organize videos into a new project or group.
  - body: { name: string }
- `POST https://api.mcp.ai/api/spotlightr/create/video` — 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.
  - body: { URL: string, hls?: integer, name: string, create?: integer, customS3?: string, videoGroup?: string, playerSettings?: object }
- `POST https://api.mcp.ai/api/spotlightr/delete/video` — Tool to delete or remove videos from Spotlightr projects. Use when you need to permanently delete one or more videos by their IDs.
  - body: { video_ids: integer[] }
- `POST https://api.mcp.ai/api/spotlightr/get/domains` — Tool to retrieve whitelisted domains for a Spotlightr account. Use when you need to list all domains approved for embedding videos.
- `POST https://api.mcp.ai/api/spotlightr/get/top/videos` — Tool to retrieve the top videos from a Spotlightr account. Use when you need to list the most viewed videos.
  - body: { days?: integer, total?: integer }
- `POST https://api.mcp.ai/api/spotlightr/get/video/metrics` — 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.).
  - body: { video_id: string }
- `POST https://api.mcp.ai/api/spotlightr/get/video/source` — 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.
  - body: { id: integer, URL: string }
- `POST https://api.mcp.ai/api/spotlightr/get/video/views` — 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.
  - body: { videoID: integer, allViews?: boolean, onlyWatched?: boolean, customViewerID?: string }
- `POST https://api.mcp.ai/api/spotlightr/list/groups` — Tool to retrieve all projects (groups) in a Spotlightr account. Use when you need to list all available projects or groups.
- `POST https://api.mcp.ai/api/spotlightr/list/videos` — Tool to retrieve videos from a Spotlightr account. Use when you need to list all videos or filter by specific video ID or project.
  - body: { video_id?: integer, video_group?: integer }
- `POST https://api.mcp.ai/api/spotlightr/search/global` — 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.
  - body: { query?: string }

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

## More
- Page: https://mcp.ai/spotlightr
- Agent spec (llms.txt): https://mcp.ai/spotlightr/llms.txt
- Postman collection: https://mcp.ai/spotlightr/postman.json