# 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

## Requirements

- Node.js >= 18
- Agnes AI API key (free at https://platform.agnes-ai.com)

## 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