Agnes MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HTTP_PORT | No | HTTP server port (only in http mode) | 3100 |
| AGNES_API_KEY | Yes | Your Agnes API key (starts with sk-) | |
| MCP_TRANSPORT | No | Transport mode: stdio or http | stdio |
| DEFAULT_DOWNLOAD_DIR | No | Root directory for auto-downloaded media |
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": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_imageB | Generate or edit an image using the Agnes AI image generation API. Supports text-to-image and image-to-image modes. |
| generate_videoA | Submit a video generation task. By default returns a videoId immediately for progress polling with |
| get_videoA | Get the current status of a video generation task and optionally download it. Accepts videoId (required) and taskId (optional). Returns progress percentage, status (queued/in_progress/completed/failed), and download URL when completed. Provide outputDir to auto-download the video file when generation is complete. |
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 3 tools
Each tool targets a distinct operation: image generation, video generation submission, and video status polling/download. No overlapping functionality, making selection unambiguous.
All tool names follow a consistent verb_noun pattern in snake_case (generate_image, generate_video, get_video), with no deviations or mixed conventions.
Three tools cover the essential workflows for image and video generation without unnecessary bloat, fitting well within the ideal 3-15 range.
Core generation and status retrieval are covered. Missing delete or list operations for generated content, but these are minor gaps given the server's likely purpose.