Developers
Build with Video Moment Finder
OAuth-protected Claude connector plus a public REST API and CLI for upload, indexing, and text search.
Claude Connector
The remote MCP server is available at https://api.videomomentfinder.com/mcp. It uses OAuth 2.0 authorization-code + PKCE and bills against Developer Pack API units.
Upload Video
upload_video
Starts a presigned upload or completes it after the bytes are written.
Get Video Status
get_video_status
Checks the current indexing state for one video.
List Videos
list_videos
Lists recent videos for the connected account.
Search Video
search_video
Runs text search against a ready video and returns timestamps.
Get Transcript
get_transcript
Fetches the full spoken transcript with per-segment timestamps.
Get Frames
get_frames
Fetches frame images at given timestamps as image content, defaulting to high resolution.
MCP Prompts
Lecture Notes
lecture_notes
Guided workflow that turns an indexed lecture video into polished Markdown study notes: transcript, then board-moment frames, then structured LaTeX notes.
Developer Pack
$20
10,000 API units
- 500 units per indexed video
- 1 unit per text query
- 1 unit per transcript fetch
- 1 unit per thumbnail frame call (up to 25 timestamps)
- 5 units per high-res frame call (up to 8 timestamps)
- Required for Claude connector usage
- Also powers REST API and CLI indexing/search calls
What a workflow costs
Index a video once for ~500 units. After that, each search or transcript fetch is 1 unit, and each frame call is 1 unit (thumbnail) or 5 units (high-res) — billed per call, not per frame.
Example — turning a lecture into study notes: ~500 units the first time you index it, then typically ~6-16 units per notes session (one transcript fetch plus one to three high-res frame calls; minimum ~2, maximum ~21), regardless of video length.
Connect Flow
- Add a custom connector in Claude with server URL https://api.videomomentfinder.com/mcp.
- Use guided OAuth. Claude surfaces that support dynamic client registration can self-register, and internal review flows may still use provided static credentials.
- Click Connect, then sign in to Video Moment Finder if needed.
- Buy a Developer Pack if your API-unit balance is zero.
- Review the six MCP tools and approve access.
Reviewer note: keep the confidential client secret out of public docs. Share review credentials only through the secure review packet or environment configuration.
REST API And CLI
REST and CLI remain the canonical public contract for direct programmatic use. They still authenticate with vmf_ API keys.
POST /api/v1/videos/uploadPOST /api/v1/videos/{id}/searchGET /api/v1/videos/{id}/transcriptPOST /api/v1/videos/{id}/frames
Example Prompts
List my recent videos in Video Moment Finder.
Claude uses list_videos and returns recent IDs, status, and source details.
Check whether video <video_id> is ready and tell me if it failed.
Claude uses get_video_status and reports the current processing state or failure reason.
Search video <video_id> for the moment they explain the model and give me timestamps.
Claude uses search_video and returns timestamped text-search matches.
Turn this lecture video into study notes.
Claude runs the lecture_notes prompt: get_transcript for the full transcript, then get_frames for the key board moments, and returns Markdown notes with LaTeX math and a Main Takeaways section.
Privacy And Support
Source uploads are temporary and may be deleted after processing. Indexed search data, transcript embeddings, and thumbnails remain available while the account is active.