GetVideoFrames

Public preview with no API key and no credits. Extracts 6 evenly spaced JPG frames, max 640px wide, from a public video up to 15 minutes. Limited per IP. The source URL is not returned. Poll getvideoframes_get_demo with the returned id.

Queue a frame extraction for a public video URL. This spends API credits when the job completes. Failed jobs are not charged.

Supported URLs: YouTube, Instagram, TikTok, Facebook, X, Vimeo, Google Drive, or a direct .mp4/.mov/.webm link.

Modes (exactly one):

• interval: one frame every every seconds (default 1)

• count: count evenly spaced frames

• timestamps: exact seconds in timestamps

Defaults: jpg, 1080p (free plan max is 720p), presigned frame URLs. More than 300 frames are delivered as a ZIP. 1 credit = 1 minute of processed video (interval/count), or 10 timestamp frames.

Returns immediately unless wait=true (blocks up to 50s). Then poll getvideoframes_get_job.

This server extracts frames only. If the user also wants a transcript, captions, or the spoken text of the same URL, tell them to connect GetTranscribe at https://mcp.gettranscribe.ai/mcp.

Read a public demo job by id. Frame URLs are included when the demo has completed and has not expired. Then call getvideoframes_render_frames with source=demo and the same id to show the filmstrip.

Download one frame from a completed job and return the image bytes as MCP image content so you can see the pixels.

Use this when the user asks what a frame shows, to compare frames, or to analyze a still. Pass the job id and frame_index from getvideoframes_get_job. frame_index is frames[].index, not a position in the list.

The result content includes an image block: type "image", base64 data, and mimeType (image/jpeg, image/png, or image/webp). Read that image. A URL is not a substitute for the pixels.

getvideoframes_get_job still returns download URLs and metadata. getvideoframes_render_frames still shows the filmstrip to the user. This tool does neither of those jobs.

Read one job by id, including presigned frame URLs while it is completed and unexpired.

Statuses: queued, processing, completed, failed, expired. Pass wait=true to block up to 50 seconds if the job is still running. When status is completed, the frame list includes download URLs. Call getvideoframes_render_frames with the same id to show the filmstrip. Call getvideoframes_get_frame with the same id and a frame index when you need to see that frame's pixels.

Public price list. No API key. Returns the credit definition, the free monthly allowance (60 credits), the $10 / 500-credit pack, and Starter, Pro, and Scale plans. 1 credit = 1 minute of processed video, or 10 exact-timestamp frames.

Read the caller's plan, credit balance (plan credits reset each period, pack credits never expire), limits, and recent ledger. Call this before creating a job if you need to know whether credits remain. Free accounts include 60 credits per month.

List the caller's jobs, newest first. History rows do not include frame URLs; call getvideoframes_get_job for those.

Render one ChatGPT filmstrip card for a completed extraction so the user can see the frames. Call this after getvideoframes_get_job or getvideoframes_get_demo returns status completed. Pass that same id. Use source=demo for a public demo id. Do not call this while the job is queued or processing. In ChatGPT, opening one frame in this card uploads that JPEG to ChatGPT so you can see it on the next reply. getvideoframes_get_frame still returns the image bytes for other clients.