Back to Templates

Complete Video Management System for AI Agents with api.video

Created by

Created by: David Ashby || cfomodz

David Ashby

Last update

Last update 2 days ago

Share


⚠️ ADVANCED USE ONLY - api.video MCP Server (47 operations)

🚨 This workflow is for advanced users only!

This MCP server contains 47 operations which is significantly more than the recommended maximum of tools for most AI clients.

🔍 Recommended Alternative for basic use cases

Seek a simplified MCP server that utilizes the official n8n tool implementation for api.video if available, or an MCP server with only common operations as it will be more efficient and easier to manage.

🛠️ Advanced Usage Requirements

BEFORE adding this MCP server to your client:

Disable or delete unused nodes - Review sections and disable/delete those you don't need

AFTER adding the MCP server to your client:
1.Selective tool enabling - Instead of enabling all tools (default), manually select only the specific tools you need for that Workflow's MCP client.
2. Monitor performance - Too many tools can slow down AI responses

💡 Pro Tips

Keep maximum 40 enabled tools - Most AI clients perform better with fewer tools

  • Group related operations and only enable one group at a time
  • Use the overview note to understand what each operation group does

⚡ Quick Setup

  1. Import this workflow into your n8n instance
  2. Credentials Add api.video credentials
  3. Activate the workflow to start your MCP server
  4. Copy the webhook URL from the MCP trigger node
  5. Connect AI agents using the MCP URL

🔧 How it Works

This workflow converts the api.video API into an MCP-compatible interface for AI agents.

MCP Trigger: Serves as your server endpoint for AI agent requests
HTTP Request Nodes: Handle API calls to https://ws.api.video
AI Expressions: Automatically populate parameters via $fromAI() placeholders
Native Integration: Returns responses directly to the AI agent

📋 Available Operations (47 total)

🔧 Account (1 endpoints)

GET /account: Show account

🔧 Analytics (3 endpoints)

GET /analytics/live-streams/{liveStreamId}: List live stream player sessions
GET /analytics/sessions/{sessionId}/events: List player session events
GET /analytics/videos/{videoId}: List video player sessions

🔧 Auth (2 endpoints)

POST /auth/api-key: Authenticate
POST /auth/refresh: Refresh token

🔧 Live-Streams (7 endpoints)

GET /live-streams: List all live streams
POST /live-streams: Create live stream
DELETE /live-streams/{liveStreamId}: Delete a live stream
GET /live-streams/{liveStreamId}: Show live stream
PATCH /live-streams/{liveStreamId}: Update a live stream
DELETE /live-streams/{liveStreamId}/thumbnail: Delete a thumbnail
POST /live-streams/{liveStreamId}/thumbnail: Upload a thumbnail

🔧 Players (7 endpoints)

GET /players: List all players
POST /players: Create a player
DELETE /players/{playerId}: Delete a player
GET /players/{playerId}: Show a player
PATCH /players/{playerId}: Update a player
DELETE /players/{playerId}/logo: Delete logo
POST /players/{playerId}/logo: Upload a logo

🔧 Upload (1 endpoints)

POST /upload: Upload with an upload token

🔧 Upload-Tokens (4 endpoints)

GET /upload-tokens: List all active upload tokens.
POST /upload-tokens: Generate an upload token
DELETE /upload-tokens/{uploadToken}: Delete an upload token
GET /upload-tokens/{uploadToken}: Show upload token

🔧 Videos (18 endpoints)

GET /videos: List all videos
POST /videos: Create a video
DELETE /videos/{videoId}: Delete a video
GET /videos/{videoId}: Show a video
PATCH /videos/{videoId}: Update a video
GET /videos/{videoId}/captions: List video captions
DELETE /videos/{videoId}/captions/{language}: Delete a caption
GET /videos/{videoId}/captions/{language}: Show a caption
PATCH /videos/{videoId}/captions/{language}: Update caption
POST /videos/{videoId}/captions/{language}: Upload a caption
GET /videos/{videoId}/chapters: List video chapters
DELETE /videos/{videoId}/chapters/{language}: Delete a chapter
GET /videos/{videoId}/chapters/{language}: Show a chapter
POST /videos/{videoId}/chapters/{language}: Upload a chapter
POST /videos/{videoId}/source: Upload a video
GET /videos/{videoId}/status: Show video status
PATCH /videos/{videoId}/thumbnail: Pick a thumbnail
POST /videos/{videoId}/thumbnail: Upload a thumbnail

🔧 Webhooks (4 endpoints)

GET /webhooks: List all webhooks
POST /webhooks: Create Webhook
DELETE /webhooks/{webhookId}: Delete a Webhook
GET /webhooks/{webhookId}: Show Webhook details

🤖 AI Integration

Parameter Handling: AI agents automatically provide values for:
• Path parameters and identifiers
• Query parameters and filters
• Request body data
• Headers and authentication

Response Format: Native api.video API responses with full data structure

Error Handling: Built-in n8n HTTP request error management

💡 Usage Examples

Connect this MCP server to any AI agent or workflow:

Claude Desktop: Add MCP server URL to configuration
Cursor: Add MCP server SSE URL to configuration
Custom AI Apps: Use MCP URL as tool endpoint
API Integration: Direct HTTP calls to MCP endpoints

✨ Benefits

Zero Setup: No parameter mapping or configuration needed
AI-Ready: Built-in $fromAI() expressions for all parameters
Production Ready: Native n8n HTTP request handling and logging
Extensible: Easily modify or add custom logic

🆓 Free for community use! Ready to deploy in under 2 minutes.