Skip to main content
Agent vision lets a compatible AI client search your video library, retrieve video details, and inspect matched frames.

How it works

When an agent calls search_videos, results include thumbnail_base64, a base64-encoded JPEG of the matched frame. A vision-capable model can use this image without fetching a separate URL:
  1. The agent searches for a video segment.
  2. Pureframe AI returns matching metadata and a frame image.
  3. The model uses the returned evidence to answer the request.
The model may still make mistakes. Ask it to cite the source video and timestamp, and let users open the returned playback URL for verification.

Two ways to connect

MCP: use an MCP-compatible client such as Claude, Cursor, VS Code, Codex, or OpenCode. See MCP overview and Connect an agent. Direct HTTP or function calling: fetch the OpenAI-compatible tool schema when you are building your own agent integration:
Pass schema to the tool configuration supported by your model provider.

Search and inspect a frame with Claude

Set ANTHROPIC_MODEL to a vision-capable model available to your Anthropic account.

Tool response fields

search_videos returns a list of clips. Each clip: Use these fields to make an answer verifiable. See Source-backed results.