🎨 Agnes AI MCP Server

Free Text-to-Image & Text-to-Video generation via Agnes AI

English | 中文

🚀 Quick Start

# 1. Install (one command)
pip install agnes-mcp

# 2. Get a free API key at https://agnes-ai.com

# 3. Add to your MCP client config:

Claude Desktop / Cursor / Windsurf (claude_desktop_config.json or equivalent):

{
  "mcpServers": {
    "agnes-mcp": {
      "command": "uvx",
      "args": ["agnes-mcp"],
      "env": {
        "AGNES_API_KEY": "your-api-key-here"
      }
    }
  }
}

Codex (config.toml):

[mcp_servers.agnes_mcp]
command = "uvx"
args = ["agnes-mcp"]

[mcp_servers.agnes_mcp.env]
AGNES_API_KEY = "your-api-key-here"

That's it! Now you can generate images and videos directly from your AI assistant.

Related MCP server: TensorsLab MCP Server

✨ Why Agnes MCP?

Yes, it's completely free. Agnes AI currently offers all image and video generation at $0. Just register and get an API key.

🖼️ Demo

Text-to-Image (agnes-image-2.1-flash)

"A majestic dragon flying over a Chinese mountain landscape at sunset, cinematic lighting, epic fantasy art"

Text-to-Image (agnes-image-2.0-flash)

"A cozy Japanese ramen shop at night, warm lantern light, rain falling, anime style"

📦 Tools

⚙️ Environment Variables

🔑 Get a Free API Key

1. Visit https://agnes-ai.com

2. Create an account (free)

3. Go to Console → API Keys → Create

4. Copy the key and paste into your config

✅ Supported Clients

• Claude Desktop

• Codex (OpenAI)

• Cursor

• Windsurf

• Cherry Studio

• Any MCP client with stdio transport

📋 Changelog

v0.3.0 (2026-06-28)

• ✨ New tool: image_to_video — animate a static image into video

• ✨ New tool: keyframe_animation — smooth transitions between multiple keyframe images

• ✨ text_to_video: added mode and num_inference_steps parameters

• ✨ create_video_task / generate_video: support mode (e.g. ti2vid, keyframes) and num_inference_steps

• ✅ 28 tests passing

v0.2.0 (2026-06-27)

• ✨ New tool: image_to_image — generate from reference image(s) + prompt

• ✨ text_to_image: batch generation (n: 1-4) and multi-image composition (images)

• ✨ text_to_video: multi-image video / keyframe animation (images)

• 🐛 Unified multi-image download logic

• ✅ 19 tests passing

v0.1.1 (2026-06-26)

• 🚀 Initial public release

• text_to_image, text_to_video, check_video_status

• Async httpx with retry mechanism

• Auto-download to local filesystem

🤝 Contributing

See CONTRIBUTING.md for guidelines.

📄 License

MIT