# api.video MCP by usefulapi

> api.video MCP by usefulapi is a freemium MCP server for design and media. Hosted MCP server to manage api.video videos, live streams and play analytics from AI. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API, vscode, CLI
- **Website:** https://usefulapi.io/apivideo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/apivideo
- **MCP Registry name:** io.usefulapi/apivideo
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-18

## About

The README and site describe a hosted remote endpoint rather than a local install, so you add one URL to a client such as Claude, ChatGPT or Cursor and sign in with your api.video API key through a login page. Once connected, the assistant can list and inspect videos, check whether an upload has finished encoding, read player URLs and captions, and pull play analytics for videos and live streams over a date range.

The server exposes 19 tools in total. Eleven are read-only, while four can create or change data: creating and updating videos, deleting a video, and creating live streams. The README notes that clients should ask for confirmation before running write tools. Four meta tools report usage against the free monthly cap and handle the Pro and Pro+ subscriptions.

The server is run by usefulapi, which the site states is independent and not affiliated with api.video. It is aimed at developers and video teams who already host content on api.video and want to query or manage it conversationally.

## Features

- **Video management:** List, inspect, update and delete videos, with filters for title, tags, metadata and description.
- **Encoding status checks:** Reads upload progress, encoding qualities and playability to show whether a video is ready to play.
- **Live stream access:** Lists live streams and returns stream keys, RTMP ingest URLs and player URLs, and can create new streams.
- **Play analytics:** Aggregates plays for videos and live streams over a date range, grouped by a chosen dimension.
- **Captions and players:** Lists caption and chapter tracks for a video and the customized player themes in the account.
- **Webhook listing:** Lists configured webhooks, optionally filtered by event name.

## Good for

- Finding which videos received the most plays in a given period
- Checking whether a newly uploaded video has finished processing
- Listing all videos with a particular tag and their links
- Renaming or updating metadata on existing videos through a chat request
- Creating a video by ingesting it from a public URL

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http apivideo https://apivideo.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://apivideo.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "apivideo": {
      "url": "https://apivideo.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "apivideo": {
      "type": "http",
      "url": "https://apivideo.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "apivideo": {
      "serverUrl": "https://apivideo.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "apivideo": {
      "type": "http",
      "url": "https://apivideo.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `apivideo_list_videos`: List videos in the account, with optional filters (title, tags, metadata, description, liveStreamId) and sorting. Read-only. GET /videos.
- `apivideo_get_video`: Get a single video object by id (title, assets, player URL, status flags). Read-only. GET /videos/{videoId}.
- `apivideo_get_video_status`: Get encoding and ingest status for a video (upload progress, encoding qualities, playability). Read-only. GET /videos/{videoId}/status.
- `apivideo_list_live_streams`: List live streams in the account, with optional filters (streamKey, name) and sorting. Read-only. GET /live-streams.
- `apivideo_get_live_stream`: Get a single live stream object by id (stream key, RTMP ingest, player URL). Read-only. GET /live-streams/{liveStreamId}.
- `apivideo_list_captions`: List caption tracks for a video (language, source URL, default flag). Read-only. GET /videos/{videoId}/captions.
- `apivideo_list_chapters`: List chapter tracks for a video. Read-only. GET /videos/{videoId}/chapters.
- `apivideo_list_players`: List customized player themes in the account. Read-only. GET /players.
- `apivideo_list_webhooks`: List webhooks configured in the account, optionally filtered by event name. Read-only. GET /webhooks.
- `apivideo_get_video_analytics`: Aggregated play analytics for videos over a date range, grouped by a dimension. Read-only. GET /analytics/videos/plays.
- `apivideo_get_live_stream_analytics`: Aggregated play analytics for live streams over a date range, grouped by a dimension. Read-only. GET /analytics/live-streams/plays.
- `apivideo_create_video`: WRITE. Create a new video object. If `source` (a public video URL) is provided, api.video ingests the video from that URL — recommended for hosted use, since raw file bytes cannot stream through MCP. POST /videos.
- `apivideo_update_video`: WRITE. Update fields on an existing video. Only the provided fields are changed. PATCH /videos/{videoId}.
- `apivideo_delete_video`: WRITE. Permanently DELETE a video and all its assets. This cannot be undone. DELETE /videos/{videoId}.
- `apivideo_create_live_stream`: WRITE. Create a new live stream, returning a stream key and RTMP ingest URL to broadcast to. POST /live-streams.

## FAQ

### How do I connect it?

Add the server URL as a custom connector or remote MCP server in your client, then log in once with your api.video API key. The site says not to add an Authorization header or API key to the client config.

### Can the AI change my data?

Yes. Four of the 19 tools can create, update or delete data. The other tools are marked read-only.

### Is this an official api.video product?

No. The site says usefulapi is an independent service and is not affiliated with or endorsed by api.video.

### What does it cost?

The Free plan includes 50 tool calls per month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls. Each subscription covers this server only.

### Is api.video MCP by usefulapi free?

api.video MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add api.video MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http apivideo https://apivideo.usefulapi.io/mcp

### What are the best alternatives to api.video MCP by usefulapi?

The closest alternatives to api.video MCP by usefulapi are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 14 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/api-video-mcp-by-usefulapi
