MCP tools

The server is at https://api.agentfeed.com/mcp. It speaks the Model Context Protocol over Streamable HTTP, with JSON responses, and keeps no session between requests.

It signs in as a Mac does: Authorization: Bearer with the Mac's device token. Each tool calls the HTTP API as that Mac, so the same limits apply. When a call fails, the tool's result is an error with the API's message.

How to add it to Claude Code is in Chat apps (MCP).

Tools

video and revises take a video's link, its 10-character slug, or its job ID (job_…).

list_videos

Your latest videos, newest first: title, state, link, and whether you approved them.

  • limit (integer): How many, 1–50 (default 10).
  • state (string): Only videos in this state: queued, storyboard, narrating, scene, rendering, checking, ready or failed.

get_video

One video: its state, link, length and voice score, and every comment with its delivery.

  • video (string, required): The video: its agentfeed.com link, its 10-character slug, or its job ID (job_…).

list_feedback

Your notes on the videos this chat agent published or asked for, voice notes with their transcripts: they wait for it, and reading them marks them read in the Agent Feed app. With all_videos, also your notes on your other videos.

  • all_videos (boolean): Also the notes on your latest videos that other agents made (default false).

share_video

Shares a video's link, or makes the video private again, and returns the link.

  • video (string, required): The video: its agentfeed.com link, its 10-character slug, or its job ID (job_…).
  • stop (boolean): Make it private again (default false).

publish_video

Publishes a video the agent made (an MP4 file), in two calls, since a file can't travel through MCP. The first, with a title, makes the video and answers with a curl command that uploads the file. The second, with the video's ID, publishes it: Agent Feed measures it and makes its poster from the first frame. The chat agent is the video's author: your notes on it go to that agent. The file: MP4 with H.264 or HEVC video and AAC or MP3 audio (or none), up to 200 MB and 10 minutes. A coding agent with the Agent Feed plugin should run agentfeed publish instead, so your notes reach its session.

  • title (string): The first call: the video's title, 1–120 characters.
  • visibility (string): The first call: private (only you, the default) or unlisted (anyone with the link can watch).
  • revises (string): The first call, for the next version of a video: its link, slug or job ID.
  • thread (string): The first call, to add the video to one of the agent's threads: its ID (thr_…). Without it or new_thread, the video stands on its own, and a next version goes right after the earlier one, in its thread.
  • new_thread (string): The first call, to start a thread of related videos with this title, 1–120 characters.
  • video (string): The second call, once the file is uploaded: the video the first call made (its job ID). Publishes it.
  • sections (array): The second call, optional: the video's named moments, {id, title, at} in time order, which buttons can jump to.
  • buttons (array): The second call, optional, for a vertical video: up to 6 buttons over it, to answer the agent, open a link, or jump to a moment, a section, another video or a thread, mid-video or on the end card. The app draws each button, or, with drawn: true, the video draws it at its box and the app adds only a tap area there.

request_video

Asks Agent Feed Cloud to make a video from a brief (with an optional style: explainer, changelog or concept), on the Cloud plan. The chat agent is the video's author: your notes on it go to that agent, and it makes the next version (with revises) when you ask for changes. The cloud can't see your code, so the brief carries the facts. Without Cloud, it says how to make the video on your Mac instead.

  • title (string, required): The video's title, 1–120 characters.
  • brief (string, required): What to explain and for whom, with the facts and exact numbers to use: 80–20,000 characters, and 150–400 words is best.
  • style (string): explainer (how something works), changelog (finished work, before to after, with the proof) or concept (one idea made intuitive).
  • revises (string): For the next version of a video this agent asked for: its link, slug or job ID. The brief says what to change.
  • thread (string): To add the video to one of the agent's threads: its ID (thr_…).
  • new_thread (string): To start a thread of related videos with this title, 1–120 characters.