Agnes Video 2.5 MCP Service
Standalone MCP server wrapping Agnes Video 2.5 and Agnes Video 2.5 Flash with first-class reference mode support (image / audio / video reference via images[] / audios[] / videos[] arrays and <Picture N> / <Audio N> / <Video N> prompt placeholders).
This service is independent of hosted_mcps/agnes-mcp-studio/ (which targets the legacy agnes-video-v2.0 model). Run it alongside or replace — both can coexist.
When to use this service
| Need | Use this service | Use agnes-mcp-studio |
|---|---|---|
| Reference-mode video (images / audios as visual + audio anchors) | ✅ | ❌ (only extra_body.image keyframes) |
First / last frame control (first_frame / last_frame) |
✅ | ❌ (only mode="ti2vid" + mode="keyframes") |
| Legacy v2.0 model (back-compat with existing pipelines) | ❌ | ✅ |
| Image generation (text-to-image, image edit, 2.5-flash) | ✅ | ✅ (parallel surface) |
Install
cd hosted_mcps/agnes-video-25
uv sync # installs the package + dependencies
Run standalone (stdio MCP)
uv run agnes-video-25-mcp
Wire into .mcp.json
Add alongside multimedia-creator:
{
"mcpServers": {
"multimedia-creator": { /* existing agnes-mcp-studio entry */ },
"agnes-video-25": {
"command": "uv",
"args": [
"--directory", "/absolute/path/to/hosted_mcps/agnes-video-25",
"run", "agnes-video-25-mcp"
],
"env": {
"AGNES_API_KEY": "sk-your-key-here",
"AGNES_BASE_URL": "https://api.agnes-ai.cn/v1"
}
}
}
}
Environment variables
| Variable | Required | Default | Notes |
|---|---|---|---|
AGNES_API_KEY |
yes | — | Same key works for .agnes-ai.cn (CN) or .agnes-ai.com (intl) — pick the matching AGNES_BASE_URL. |
AGNES_BASE_URL |
no | https://api.agnes-ai.cn/v1 |
API root. CN / intl keys are not interchangeable. |
AGNES_OUTPUT_DIR |
no | ./outputs |
Where downloaded media land (videos → <dir>/videos/, images → <dir>/images/). Use an absolute path for predictable layouts. |
Tools
| Tool | Purpose |
|---|---|
agnes25_video_submit |
Submit video task, return video_id immediately |
agnes25_video_status |
Poll a single video status |
agnes25_video_wait |
Poll video until completed / failed / timeout, download to disk |
agnes25_video_generate |
Submit + wait + download video in one call |
agnes25_image_generate |
Generate images (text-to-image + optional img2img via image_paths) |
agnes25_image_generate_v2 |
Same as _generate; explicit v2 surface for parity |
agnes25_image_edit |
Edit images via image_paths + optional mask_path (inpainting) |
Full schema: see SKILL.md. Public docs:
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agnes_video_25_mcp-0.1.2.tar.gz.
File metadata
- Download URL: agnes_video_25_mcp-0.1.2.tar.gz
- Upload date:
- Size: 74.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ffdb0318654d0c879a7f324c113e3cf6e888a32aeb75482965ae33d4a24c07e8
|
|
| MD5 |
ce977efef84a5e8034c9c1f9c7a04bfa
|
|
| BLAKE2b-256 |
f9fda67263d5aa04cf4d97c12b45e82705fb2a0d3d5bc4fecd3736086bc7bf66
|
File details
Details for the file agnes_video_25_mcp-0.1.2-py3-none-any.whl.
File metadata
- Download URL: agnes_video_25_mcp-0.1.2-py3-none-any.whl
- Upload date:
- Size: 12.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
668eff056e7c31f6598e259d11c165be4b40f733de128b49f632f6dc8c99fc80
|
|
| MD5 |
536b173d5d4c99811d24fcbef074e51d
|
|
| BLAKE2b-256 |
066357f2207cd6a923c63718b45e11f721ed8778dca84243cc381780ff11e736
|
