Skip to main content
With the AgentTV MCP server connected, an AI app can do three things with your library:
  1. Search moments. Find the moments that answer a question, by what is said, shown and written on screen.
  2. Answer with time-coded citations. Quote the evidence and cite the second it comes from.
  3. Play the moment. Load a player card in the chat that starts at that second.
MCP (Model Context Protocol) is how AI apps connect to outside tools. The person turns on a connector once. No code runs on your side.

​
The flow

​
Connect a library

Every listed library has its own MCP server. It needs no sign-in and no key.
  • Claude: Settings, Connectors, Add custom connector. Paste the URL.
  • ChatGPT: Settings, Apps, Advanced settings, turn on Developer mode, then Create. Paste the URL. Developer mode needs a paid plan.
  • Other apps: see Connect an MCP.
Any person you share the URL with can add it. You do not need an app directory listing. See App directories.

​
The tools

The tool descriptions tell the AI app when to use each one. The app decides which to call.

​
What plays where

HLS (HTTP Live Streaming) is the streaming format that uses .m3u8 playlists. Today the player card in the chat is the AgentTV player, so your own web player and its tags do not load inside the chat. When the AgentTV player plays your video, it reads the stream from your own hosts through AgentTV’s stream proxy. Your CDN serves the bytes. The proxy reads only from hosts on your allow list. See Play in your own player.

​
Playback sessions

get_video_stream returns a signed session next to stream_url, share_url and expires_at. The session is signed for one video and one start time. Store video_id and segment_id, not the stream URL. After expires_at, call get_video_stream again. Search, fetch and the ARV record never return a stream URL. Only get_video_stream does, after it checks your rights.

​
Tracking

  • Every signed play and every reported use is logged against your account.
  • The AI app usage report shows which AI apps cited or played your videos, and how often. Read it with GET /v1/reports/agent-usage.
  • Usage receipts are signed. Check them against the keys at https://api.agentcdn.com/.well-known/jwks.json.
See Measure usage.

​
Try it

Ask in a new chat once the connector is on:
  • “Find the moment where the winning run starts, and play it.”
  • “What happened in the second set? Cite the times.”
  • “List every match in this replay with its start time.”