Skip to content

tellers-ai/mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tellers MCP Server

An MCP server that brings Tellers AI video creation into any MCP-compatible client (Claude Desktop, Cursor, etc.).

Describe the video you want in plain language. The server handles everything else — generation, editing, exporting, and sharing.

Prerequisites

  • Node.js 18+
  • A Tellers account with an API key (app.tellers.ai → user menu → API keys → Create new)

Setup

npm install
npm run build

Configuration

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "tellers": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/build/index.js"],
      "env": {
        "TELLERS_API_KEY": "sk_..."
      }
    }
  }
}

The config file is located at:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop after saving.

Available Tools

Tool Description
tellers_generateVideo Create or edit a video from a natural-language prompt
tellers_uploadMedia Upload a local file to use as source footage
tellers_exportProject Render a project to a downloadable MP4
tellers_makeAssetPublic Publish an asset and get a shareable preview link
tellers_listRecentAssets Browse your recent assets and exports
tellers_listChats List recent generation sessions
tellers_getChatMessages View the message history of a session
tellers_getSettings Inspect available AI models and account configuration

Usage Examples

Generate a video from scratch:

"Create a 30-second product highlight reel with upbeat music"

Edit uploaded footage:

Upload your clips with tellers_uploadMedia, then: "Cut this footage to 60 seconds, add text overlays, and color grade it warm"

Export and share:

Call tellers_exportProject with the project ID, then tellers_makeAssetPublic to get a shareable link.

Resume a session:

Pass the chat_id from a previous tellers_generateVideo call to continue refining the same project.

Credits

Operations consume Tellers credits. New accounts receive starter credits. Top up at app.tellers.ai.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors