AutoVio MCP Server

MCP server for the AutoVio AI video generation pipeline. Connects Claude Code, Claude Desktop, Cursor, and any MCP-compatible client to the AutoVio API — no clone or build required.

Installation

No installation needed. Use npx to run the server directly:

npx autovio-mcp --autovio-base-url http://localhost:3001 --autovio-api-token YOUR_TOKEN

Or install globally:

npm install -g autovio-mcp
autovio-mcp --autovio-base-url http://localhost:3001 --autovio-api-token YOUR_TOKEN

Quick Start

Claude Code

claude mcp add autovio-mcp -- npx -y autovio-mcp \
  --autovio-base-url http://localhost:3001 \
  --autovio-api-token YOUR_TOKEN \
  --llm-model gemini-2.5-flash \
  --llm-api-key YOUR_KEY \
  --image-model gemini-2.5-flash-image \
  --image-api-key YOUR_KEY \
  --video-model veo-3.0-generate-001 \
  --video-api-key YOUR_KEY

Claude Desktop / Cursor

Add to your claude_desktop_config.json (or equivalent MCP config):

{
  "mcpServers": {
    "autovio": {
      "command": "npx",
      "args": [
        "-y", "autovio-mcp",
        "--autovio-base-url", "http://localhost:3001",
        "--autovio-api-token", "YOUR_TOKEN",
        "--llm-model", "gemini-2.5-flash",
        "--llm-api-key", "YOUR_KEY",
        "--image-model", "gemini-2.5-flash-image",
        "--image-api-key", "YOUR_KEY",
        "--video-model", "veo-3.0-generate-001",
        "--video-api-key", "YOUR_KEY"
      ]
    }
  }
}

Configuration

Config is loaded from four sources in priority order: CLI flags > environment variables > config file > defaults.

CLI flags

| Flag | Description | |------|-------------| | --autovio-base-url | AutoVio API base URL (default: http://localhost:3001) | | --autovio-api-token | AutoVio API token | | --config | Path to a JSON config file | | --vision-model | Vision model (e.g. gemini-2.0-flash-exp) | | --vision-api-key | Vision API key | | --llm-model | LLM model (e.g. gemini-2.5-flash) | | --llm-api-key | LLM API key | | --image-model | Image model (e.g. gemini-2.5-flash-image) | | --image-api-key | Image API key | | --video-model | Video model (e.g. veo-3.0-generate-001) | | --video-api-key | Video API key | | --log-level | debug | info | warn | error | | --enable-resources | true | false | | --enable-prompts | true | false |

CamelCase variants (e.g. --autovioBaseUrl) are also accepted.

Environment variables

AUTOVIO_BASE_URL        AUTOVIO_API_TOKEN
AUTOVIO_VISION_MODEL    AUTOVIO_VISION_API_KEY
AUTOVIO_LLM_MODEL       AUTOVIO_LLM_API_KEY
AUTOVIO_IMAGE_MODEL     AUTOVIO_IMAGE_API_KEY
AUTOVIO_VIDEO_MODEL     AUTOVIO_VIDEO_API_KEY
AUTOVIO_LOG_LEVEL       AUTOVIO_MCP_CONFIG

Config file

Pass a JSON file with --config path/to/config.json. See examples/config.example.json for the full structure.

Available Tools

| Tool | Description | |------|-------------| | autovio_health | API health check | | autovio_auth_login | Login (email + password) | | autovio_auth_register | Register new user | | autovio_auth_me | Current user info | | autovio_projects_list | List projects | | autovio_projects_create | Create project | | autovio_projects_get | Get project details | | autovio_projects_update | Update project | | autovio_projects_delete | Delete project | | autovio_works_list | List works | | autovio_works_create | Create work | | autovio_works_get | Get work details | | autovio_works_update | Update work | | autovio_works_delete | Delete work | | autovio_works_apply_template | Apply template to work | | autovio_ai_analyze_video | Analyze reference video for style/tone | | autovio_ai_generate_scenario | Generate scene-by-scene scenario | | autovio_ai_generate_scenario_for_work | Generate scenario attached to a work | | autovio_ai_generate_image | Generate image from prompt | | autovio_ai_generate_video | Animate image into video clip | | autovio_ai_generate_scene | Generate image + video for one scene | | autovio_providers_list | List available AI providers | | autovio_templates_list | List templates | | autovio_templates_get | Get template details | | autovio_templates_create | Create template | | autovio_templates_update | Update template | | autovio_templates_delete | Delete template |

Requirements

• Node.js >= 18
• A running AutoVio backend
• An AutoVio API token (or use autovio_auth_login to get one)
• API keys for the AI providers you want to use

Links

• AutoVio — core platform
• Documentation — full MCP setup guide and tool reference
• npm

License

MIT