# Avideoai MCP

> Avideoai MCP is a paid MCP server for design and media. Turn a product photo into a short video ad from Claude or another agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://www.avideoai.com/docs
- **MCP Registry name:** io.github.jacklee1000/avideoai-mcp
- **Categories:** design and media, marketing and SEO
- **Listing updated:** 2026-11-15

## About

The agent supplies a public image URL and a prompt describing motion and scene, and the server queues a render that takes about one to three minutes. Two engines are offered: Hailuo 2.3 for 6-second clips and Veo 3.1 for 8-second clips. Credits are charged when the video is queued and refunded automatically if it fails.

There is no subscription and no free API tier. Credits are bought in packs and never expire, at $2.08 to $3.17 each by pack size. Cinematic videos cost 2 credits and Premium 4, so the page lists approximate prices of $4.15 to $6.33 for Hailuo and $8.30 to $12.67 for Veo.

Advice for builders: limits are 30 requests a minute and 3 videos in flight per key, an Idempotency-Key header prevents double charges on retry, and finished videos are kept 90 days. The server runs locally through npx and needs Node.js 20 or later and an avk_live_ key.

## Features

- **Image to video:** Starts from a product photo URL and a motion prompt.
- **Two video models:** Hailuo for 6-second clips, Veo for 8-second clips.
- **Status polling:** Check a video until it is completed or failed.
- **Credit balance check:** Read remaining credits from the agent.
- **Auto refunds:** Failed renders return their credits.
- **Idempotent retries:** A repeated request does not charge twice.

## Good for

- Generate a product ad clip for a store listing
- Batch short videos for a catalogue
- Let a content agent create and track renders
- Check credit balance before a campaign
- Prototype motion styles on a product photo

## Install

### Claude Code (Terminal)

```sh
claude mcp add avideoai-mcp --env AVIDEOAI_API_KEY='<AVIDEOAI_API_KEY>' -- npx -y avideoai-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "avideoai-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avideoai-mcp"
      ],
      "env": {
        "AVIDEOAI_API_KEY": "<AVIDEOAI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "avideoai-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avideoai-mcp"
      ],
      "env": {
        "AVIDEOAI_API_KEY": "<AVIDEOAI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "avideoai-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "avideoai-mcp"
      ],
      "env": {
        "AVIDEOAI_API_KEY": "<AVIDEOAI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "avideoai-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avideoai-mcp"
      ],
      "env": {
        "AVIDEOAI_API_KEY": "<AVIDEOAI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "avideoai-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avideoai-mcp"
      ],
      "env": {
        "AVIDEOAI_API_KEY": "<AVIDEOAI_API_KEY>"
      }
    }
  }
}
```

## Tools

- `create_product_video`: Queues a video from a product photo and prompt.
- `get_video_status`: Returns the status and link of a video.
- `check_credits`: Returns the credit balance.

## FAQ

### Is there a free tier?

No. The docs say there is no subscription and no free API tier.

### How much does a video cost?

Roughly $4.15 to $6.33 with Hailuo and $8.30 to $12.67 with Veo, depending on pack size.

### What image formats work?

JPEG, PNG or WEBP under 10 MB, at a public https URL.

### How long are videos kept?

Finished videos are kept for 90 days; the signed link lasts one hour.

### Is Avideoai MCP free?

No. Avideoai MCP is a paid product.

### How do I add Avideoai MCP to Claude Code?

Run this command in your terminal: claude mcp add avideoai-mcp --env AVIDEOAI_API_KEY='<AVIDEOAI_API_KEY>' -- npx -y avideoai-mcp

### What are the best alternatives to Avideoai MCP?

The closest alternatives to Avideoai MCP are HyperFrames by HeyGen, ffmpeg-skill, Google Ads + Meta Ads + SEO/GEO MCP, Calven and AvatarSay — Fictional Character & Talking Video MCP.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/avideoai-mcp
