# Video hosting · VideoDB

> Video hosting your agent can run.

Upload, list, transcode and stream video from Claude, ChatGPT, any MCP client or your own code. Every video comes back as a link you can play or embed. $20 of free credits, no credit card.

Canonical: https://videodb.io/video-hosting · Add to Claude: https://videodb.io/claude · Add to ChatGPT: https://videodb.io/chatgpt · MCP server: https://mcp.videodb.io/mcp

## Four hosting jobs for your agent

- **Upload**: a direct link or a YouTube link in a chat, or a file through the console or the SDK. Video, audio and images. Tool: `upload_media`.
- **List and organize**: every video with its name, its length and its links, kept in collections you name.
- **Transcode**: a new copy of a file at the resolution, frame rate and aspect ratio you ask for, with or without its audio. Tool: `transcode_media`.
- **Stream**: every video has a stream URL (HLS) and a player link. An MP4 download and a thumbnail from any timestamp are there on request.

Example in a chat: "Host this video and give me a link." The agent uploads cat-vs-ribbon.mp4, a cat playing with a ribbon, and answers with the stream link and the player page. On the page this window is an illustration with sample footage, not a recorded run.

Works in Claude and ChatGPT, and in Claude Code, Cursor, Codex or any MCP client. Install steps: https://videodb.io/agents.md

## What to ask, and what comes back

Say it in plain words. What comes back is a link or a file you can use right away. Step-by-step guide: https://videodb.io/blog/turn-video-into-link.md

- "Host this video and give me a link." You get a link that plays in any browser, with the stream behind it.
- "List everything I have uploaded, longest first." You get your library as a list, with the name, the length and a link for each video.
- "Make a 720p copy of this file." You get a new copy at the resolution, frame rate and aspect ratio you ask for.
- "Give me this one as an MP4." You get a download link for the file.
- "Grab a thumbnail from 0:12." You get that frame as an image, kept with the video.
- "Upload these into a collection called Launch." You get one collection that keeps them together, with its own list.

## Your agent can also watch what it hosts

Ask about a hosted video the way you would ask someone who has seen it. The moments it finds come back as clips, each with its own link. The six video skills: https://videodb.io/agents.md

- **Find a moment**: ask for the part where pricing comes up, and get the clip cut to that moment.
- **Ask a question**: ask what happens in the video, and get an answer with the times behind it.
- **Cut a clip**: ask for the first ten seconds. The clip is cut from the stored video when you ask, and plays from a link.
- **Add subtitles**: ask for subtitles in English, French and German, from one transcript.

## Pay for what you store and stream

The usage rates for hosting, from the live rate card (https://videodb.io/pricing.md). New accounts start with $20 of free credits and no credit card.

| Item | Rate |
|------|------|
| File uploads | $0.09 / GB |
| Media storage | $0.03 / GB / mo |
| Video streaming | $0.07 / GB |
| Transcoding SD (360p) | $0.004 / min |
| Transcoding HD (720p/1080p) | $0.009 / min |
| Downloads (720p) | $0.03 / min |

The cost calculator is on the pricing page: https://videodb.io/pricing#estimate

## Where it fits

Work that already runs through an agent and needs a home for its video.

- Agent-built apps: the agent building your app uploads its videos and writes the embed into the page. Guide for Cursor and Claude Code: https://videodb.io/blog/add-video-to-cursor-app.md
- Generated video: an agent that makes a video needs somewhere to put it. Each one gets a stream to play and share. Agentic Streams: https://videodb.io/blog/agentic-streams.md
- Screen recordings: Bloom records your screen and syncs each recording to VideoDB, where it can be searched and shared. https://videodb.io/apps/bloom.md
- Meetings and calls: Call.md records a call and keeps the recording where your agent can find the moment a decision was made. https://videodb.io/apps/call-md.md
- Game clips and streams: upload last night's stream and share the clip. Then ask for the rounds worth studying. https://videodb.io/archival-footage.md

## The same jobs from code

Python and Node SDKs for your own app. Coding agents reach the same calls through the VideoDB skills (`npx skills add video-db/skills`) and the MCP server. `pip install videodb` or `npm install videodb`; your API key is at https://console.videodb.io. Docs: https://docs.videodb.io

Example in Python (videodb 0.5.1):

```python
from videodb import connect, VideoConfig

# uses your API key from console.videodb.io
conn = connect()
coll = conn.get_collection()

# upload a file, or pass url="https://..."
video = coll.upload(file_path="launch.mp4")

# three ways to play it
stream = video.generate_stream()  # HLS
page = video.player_url           # a web page
embed = video.get_embed_code()    # an iframe

# every video in the collection, with its link
for v in coll.get_videos():
    print(v.name, v.length, v.player_url)

# a 720p copy of any file you can link to
job_id = conn.transcode(
    source="https://example.com/raw.mp4",
    callback_url="https://example.com/hook",
    video_config=VideoConfig(resolution=720))
```

## Questions

- **Is it free to start?** Yes. New accounts start with free credits and no credit card. After that you pay for uploads, storage, streaming and transcoding at the rates above. Search and questions have their own rates on the pricing page.
- **What can I upload?** In a chat, a direct link or a YouTube link. A file on your computer goes up through the console or the SDK. Video, audio and images all work.
- **Can I embed a video on my own site?** Yes. Every video has a player link, and the SDKs return an iframe embed code for it. The stream is HLS, so it also plays in any player that reads HLS.
- **Where do my videos go?** Into your own VideoDB collection, which only your account and your agents can reach. On your own cloud, the files stay in your bucket. Deleting a video removes it in full.
- **Do I need to code?** No. In Claude or ChatGPT you add the plugin and ask. The SDKs are there when you want hosting inside your own app.

## Host your first video from a chat

Adding VideoDB takes about a minute. Then upload a file or paste a link and ask for the stream. [Add to Claude](https://videodb.io/claude) · [Add to ChatGPT](https://videodb.io/chatgpt)

## Use VideoDB in your agent

VideoDB lets an AI agent watch, search and clip video.

- **Claude**: [Add VideoDB from the plugin directory](https://videodb.io/claude)
- **ChatGPT**: [Add VideoDB from the plugin directory](https://chatgpt.com/plugins/videodb)
- **Claude Code**: `claude mcp add --transport http videodb https://mcp.videodb.io/mcp`
- **Cursor or any MCP client**: Add the remote MCP server and log in once: `https://mcp.videodb.io/mcp`

Free to start: $20 of credits, no credit card. [Steps for every client](https://docs.videodb.io/pages/mcp/connect).
