Skip to content

aituberapp/aituber-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AITuber MCP Server

Create AI-powered videos from any MCP-compatible client. Generate videos with AI narration, visuals, and synced captions for YouTube Shorts, TikTok, Instagram Reels, and long-form content. Supports AI-generated images, video clips, stock footage, and viral templates like skeleton and character styles. AITuber handles script writing, voice synthesis, visual generation, and video rendering.

AITuber | API Documentation | Get API Key

What you can do

  • Generate videos from a prompt or script - describe a topic and get a fully produced video, or provide exact narration text for precise control
  • Short-form and long-form - create 15-second Shorts or 7-minute videos
  • 1,300+ AI voices - filter by gender, accent, age, or language
  • 27+ visual styles - photorealistic, anime, cinematic, 3D Pixar, watercolor, comic book, and more
  • Video templates - skeleton X-ray style, character-driven stories
  • Multiple media types - AI-generated images, AI video clips, or real stock footage
  • YouTube and Instagram - publish directly to your connected channels
  • Autopilot mode - schedule automated video creation on a recurring basis (via dashboard)
  • Export to MP4 - render and download the final video
  • Check credits and plan - monitor usage before generating

Quick start

1. Get your API key

Go to app.aituber.app/dashboard/settings and create an API key.

2. Install

Claude Desktop - add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "aituber": {
      "command": "npx",
      "args": ["-y", "@aituber/mcp-server"],
      "env": {
        "AITUBER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code:

claude mcp add aituber -e AITUBER_API_KEY=your_api_key_here -- npx -y @aituber/mcp-server

Cursor - add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "aituber": {
      "command": "npx",
      "args": ["-y", "@aituber/mcp-server"],
      "env": {
        "AITUBER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Windsurf and other MCP clients - same pattern. Point the MCP server command to npx -y @aituber/mcp-server and set the AITUBER_API_KEY environment variable in the config.

3. Start creating

Ask your AI assistant:

"Create a 60-second video about 5 mind-blowing facts about the ocean"

"List available British female voices for narration"

"Check how many credits I have left"

"Export my latest video to MP4 and give me the download link"

"List my connected channels and publish my finished video to YouTube and Instagram"

How it works

This MCP server provides two tools:

search_api

Finds the right AITuber API endpoint for your task. Describe what you want in natural language.

search_api("create a video about cats")
-> Returns: POST /videos/generate with all parameters and examples

execute_api

Calls the AITuber API. Use after search_api to know which endpoint and parameters to use.

execute_api(method: "POST", path: "/videos/generate", body: {
  "script": "5 amazing facts about the deep ocean",
  "inputType": "idea",
  "expectedDurationSeconds": 60
})
-> Returns: { videoId: "abc-123", status: "pending" }

Example workflows

Generate and download MP4

  1. Search - find the right endpoint for creating a video
  2. Generate - create the video with your script and settings
  3. Poll - check video status until generation completes
  4. Export - render the completed video to MP4
  5. Download - get the MP4 download URL

Generate and publish

  1. Generate - create the video with your script and settings
  2. Poll - wait until the video status is completed
  3. List channels - call GET /channels to find connected channel IDs
  4. Publish - call POST /publications with the videoId and per-channel settings
  5. Poll publication - call GET /publications/{publicationId} until it reaches published, scheduled, or failed

Publishing requires channels to already be connected through the AITuber dashboard and an active paid plan with the Publish feature. If the video is not exported yet, the API starts the export automatically.

API endpoints

Endpoint Description
GET /voices Browse 1,300+ AI voices with filters (public, no auth required)
POST /videos/generate Create a video from a script or idea
GET /videos List all your videos
GET /videos/{id} Get video details and generation status
GET /subscription Check your plan, credits, and billing info
POST /exports Start rendering a video to MP4
GET /exports/download Get a temporary download URL for the MP4
GET /channels List connected YouTube and Instagram channels
POST /publications Publish a completed video to one or more connected channels
GET /publications/{publicationId} Check publication status after publishing

Supported video types

Type Description How to create
Faceless narration (images) AI images with Ken Burns animation, narration, and captions Default. Just send a script or idea.
Faceless narration (video clips) AI-generated video clips instead of images Set mediaType: "video"
Stock footage Real stock footage matched to narration Set mediaType: "stock"
Skeleton template Viral "what happens if..." X-ray style Set templateId: "skeleton"
Character template Character-driven story format Set templateId: "character"

Configuration

Variable Required Default Description
AITUBER_API_KEY Yes - Your API key from AITuber dashboard
AITUBER_API_BASE_URL No https://app.aituber.app/api/v1 API base URL (override for self-hosted or testing)

Links

License

MIT

Releases

No releases published

Packages

 
 
 

Contributors