agnes-2.5-flash-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AGNES_API_KEY | Yes | Your Agnes API key for image/video generation. Can be set in MCP environment, system environment, or .env file, or overridden per-request by the api_key tool argument. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_imageA | Generate or edit an image with agnes-image-2.5-flash. Always returns a URL (or base64). 中文触发：当用户说「agnes生图 / 生成图片 / 做张图 / 文生图 / 图生图 / 改图 / 多图合成」时调用此工具。 Trigger: agnes generate image / text-to-image / image-to-image / edit image. Presets: size 1K(fast/cheap) / 2K(default, wallpaper 16:9=2624x1472) / 3K / 4K(max quality).
ratio 16:9 default (wallpaper), 1:1 social, 9:16 vertical, 21:9 ultrawide.
Pass Examples:
|
| create_videoA | Create an async agnes-video-2.5-flash task (RECOMMENDED). Returns video_id; poll with query_video. 中文触发：当用户说「生视频 / 生成视频 / 做个视频 / 图生视频 / 首尾帧 / 参考图视频」时优先调用此工具（异步默认，避免IDE超时）。 Trigger: agnes generate video (async) / text-to-video / image-to-video / keyframe. mode text: pure text (no media). keyframe: first_frame and/or last_frame required. reference: images (<=5) and/or audios (<=3) required; use / in prompt. size is fixed 720P. seconds is a string "4".."12" (default "5"). Examples:
|
| query_videoA | Query an agnes-video-2.5-flash task. Returns status/progress and video_url when completed. 中文触发：视频创建后，用此工具按 video_id 轮询进度（配合 create_video 使用）。 |
| generate_videoA | Create a video task and block-poll until completed/failed (compat; may hit client timeouts). ⚠️ 同步阻塞（易超时）：开源推荐用 create_video + query_video；此工具仅为短视频兼容保留。 中文触发：仅当用户明确说「一步到位 / 直接等视频结果」时才用，否则用 create_video。 Trigger (compat): agnes generate video sync; prefer async create_video + query_video. Same params as create_video plus poll_interval (default 2s) and timeout_seconds (default 600s). On timeout, reuse video_id with query_video. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
query_video and generate_image are clearly distinct, but create_video and generate_video describe the same core operation with different execution modes. The descriptions help differentiate them, but an agent could still easily pick the wrong one.
All names follow a snake_case verb_noun pattern, but the verbs are inconsistent: query, generate, create, generate. The create_video vs generate_video pair is especially confusing since they are near-synonyms for the same capability.
Four tools is a reasonable size for an image/video generation server. The only slight issue is that generate_video is a redundant sync variant of create_video, but it serves a compatibility purpose.
The core image generation and video creation lifecycles are covered: generate image, create video asynchronously, query status, and sync wait. Minor gaps like cancellation or image task polling are not blocking for the apparent domain.