Skip to main content
Glama
Agnes Video MCP Server

Agnes Video MCP Server

by kira4094

Agnes Video MCP Server

MCP server for Agnes Video v2.0 (text-to-video / image-to-video generation), via OpenAI-compatible API.

Features

  • Text-to-Video: Generate videos from text prompts

  • Image-to-Video: Generate videos from a starting image or keyframes

  • Async workflow: Submit task → poll for result

  • Custom resolution, frame count, frame rate, duration, seed

Related MCP server: Sisif AI MCP Server

Requirements

Environment Variables

Variable

Required

Default

Description

AGNES_API_KEY

✅

—

Agnes AI API key

AGNES_VIDEO_MODEL

agnes-video-v2.0

Model name

Tools

agnes_video_create — Submit a video generation task

Parameter

Type

Required

Default

Description

prompt

string

✅

—

Text description

width

number

1152

Video width

height

number

768

Video height

num_frames

number

121

Frames (8n+1: 121, 241, 361, 441)

frame_rate

number

24

Frame rate

duration

number

Duration in seconds

seed

number

Reproducible seed

image_url

string

Starting image URL

mode

string

ti2vid or keyframes

agnes_video_poll — Check task progress

Parameter

Type

Required

Description

task_id

string

✅

Task ID returned from agnes_video_create

Usage

1. agnes_video_create → "a cat walking on beach at sunset"
   → Returns task_id: "task_xxx"

2. agnes_video_poll → task_id: "task_xxx"
   → Returns status + progress %, or video URL when done

License

MIT

Available Tools

2 tools
agnes_video_createA

Create a video generation task using Agnes Video v2.0. Video generation is ASYNCHRONOUS — submit a task, then use agnes_video_poll to check results. Supports text-to-video (prompt only) and image-to-video (with imageUrl). num_frames must follow 8n+1 pattern (e.g. 121, 241, 361, 441)

Inputs: prompt (required), width, height, num_frames, +5 more.

agnes_video_pollA

Poll a video generation task by task_id to check progress. Returns task status and video URL when completed. The task_id is returned by agnes_video_create.

Inputs: task_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: one creates a video generation task, the other polls for its result. There is no overlap or ambiguity.

    Naming Consistency5/5

    Both tools follow a consistent 'agnesis_video_verb' pattern using snake_case. 'create' and 'poll' are clear and parallel verbs.

    Tool Count4/5

    With only 2 tools, the server is minimal but sufficient for the core asynchronous workflow of creating and polling a video task. A slight expansion (e.g., cancel or list) could be beneficial but is not necessary.

    Completeness4/5

    The tool surface covers the essential create-and-poll lifecycle for video generation. However, there is no way to cancel a task or list all tasks, which are minor gaps.

    Related MCP Connectors

    Related MCP Servers