# Using an AI agent to find and license stock footage > Add the MCP server https://video.shep.bot/mcp to your agent under the name 'video' (in Claude Code: claude mcp add --transport http video https://video.shep.bot/mcp). The agent then gets search_videos, get_video, build_sequence and list_sources. Ask for footage the way you would brief an editor, including format and use ("three 4K ocean shots for a client ad"). It searches commercial-safe by default, reports every clip's licence verdict, flags editorial footage and gives you the credit lines. AI agents guide, updated 2026-10-28. Connect Claude Code, Cursor or another agent to Video Assets Server over MCP, then ask for footage, sequences and credit lines under the licence rules. ## Prompts that work ```text Find three 4K clips of ocean waves at sunset I can use in a client ad. No editorial clips. Show me each one's licence, a watch link and the credit line. ``` ```text Build a 20-second vertical b-roll sequence for a Reel: city skyline at night (4s), coffee pour close-up (3s), people walking in the rain, clouds timelapse. Give me concat.sh and ATTRIBUTION.md. ``` ```text For a history video, find 1950s newsreel footage of factories and tell me which clips are public domain and which are unverified uploads. ``` ## What the tools do - **search_videos** searches every source with the query and filters (categories, styles, orientation, minimum resolution, length, frame rate). It parses words like "4k", "vertical" and "10s" itself, and returns links into the stock sites it can't search. - **get_video** returns one clip's licence, verdict, editorial flag, credit line, every rendition and a watch URL, plus a download link for the rendition closest to the height you want. - **build_sequence** picks one clip per shot and returns the plan with an OpenTimelineIO timeline, an ffmpeg script, a Remotion clip list and the credits. - **list_sources** lists the sources with their licences and how they are searched. - **download_video** (local servers only) saves a rendition into `./footage//` and keeps `ATTRIBUTION.md` up to date. ## The licence rules agents get Every agent that connects is told the same rules: search commercial-safe unless the user says otherwise; report each clip's verdict; never present a non-commercial, unclear or editorial clip as cleared for advertising; pass on credit lines; treat uploader-asserted licences as unverified; and for NASA footage, credit NASA and never imply endorsement or use the NASA logo. You can hold your agent to them. ## Running it locally ```bash claude mcp add video-local -- npx -y video-assets-server mcp ``` The local server adds `download_video`, and `build_sequence` can download the picks and write the exports next to them, so the timeline and the ffmpeg script use the local files. No API keys are needed for any source. ## Step by step 1. **Connect the MCP server.** Claude Code: claude mcp add --transport http video https://video.shep.bot/mcp. Cursor, VS Code, Windsurf, Codex CLI and Gemini CLI take the same URL; the docs have a snippet for each. 2. **Brief it like an editor.** Say what the shot shows, the format (vertical, 4K, at least 10 seconds) and what the video is for (ad, documentary, personal). The use decides which licences are acceptable. 3. **Review before downloading.** Ask to see the picks with their verdicts, editorial flags and watch links (https://video.shep.bot/search?clip=) before anything goes into the project. 4. **Let it fetch the files and credits.** With a shell, the agent downloads the chosen rendition via the download link; a local MCP server (npx -y video-assets-server mcp) writes the files and ATTRIBUTION.md into ./footage itself. ## Questions **Will the agent use non-commercial footage by mistake?** Searches are commercial-safe unless you say the project is personal or non-commercial, and the server instructs agents never to present non-commercial, unclear or editorial clips as cleared for advertising. Still read the verdicts it reports. **Can the agent download video on the hosted server?** The hosted server never writes to disk or streams video. It returns download links that redirect to the source, which an agent with a shell can fetch with curl. For direct downloads, run the MCP server locally. **My agent can't use MCP. What then?** Point it at https://video.shep.bot/AGENTS.md, which explains the REST API and the licence rules in a page, or install the skill from https://video.shep.bot/skill/SKILL.md in Claude Code. ## Try it - [Example: vertical ocean, commercial-safe](https://video.shep.bot/search?q=ocean+waves&orientation=portrait&commercial=true) ## Collections - [Free ocean footage: waves, beaches and seas](https://video.shep.bot/footage/free-ocean-footage.md): Free ocean stock video: breaking waves, beaches, coastlines and open sea, plus ocean science from NASA, with resolution, length and licence on every clip. - [Rocket launch footage: liftoffs and missions](https://video.shep.bot/footage/rocket-launch-footage.md): Free rocket launch videos from NASA and open archives: liftoffs, engine close-ups, tracking shots and historic launches, with credit lines and partner warnings. ## Related guides - [Build a b-roll sequence from a shot list (OTIO, ffmpeg, Remotion)](https://video.shep.bot/guides/b-roll-sequence-from-shot-list.md): Turn a shot list into a cut b-roll sequence with free stock footage: pick the frame, review the picks, export to DaVinci Resolve, ffmpeg or Remotion. - [Free stock footage for commercial use: what the licences mean](https://video.shep.bot/guides/free-stock-footage-commercial-use.md): Which free stock video you can use in ads, client work and monetised videos: CC0, public domain, CC BY, share-alike, NC, NASA and editorial footage. - [Editorial vs commercial: model releases and logos in stock footage](https://video.shep.bot/guides/editorial-vs-commercial-footage.md): Why a free clip can still be editorial-only: model releases, property releases, logos and insignia, and how to tell if footage is safe for an ad. ## Sources - [Model Context Protocol](https://modelcontextprotocol.io) - [Claude Code: connect to MCP servers](https://docs.claude.com/en/docs/claude-code/mcp) This guide is practical information, not legal advice. --- Source: https://video.shep.bot/guides/ai-agent-find-and-license-footage