Skip to main content
Glama
MSWEIMZ

Agnes AI MCP Server

by MSWEIMZ
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

ο»Ώ

🎨 Agnes AI MCP Server

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

PyPI version PyPI downloads CI License: MIT Python 3.10+ MCP Compatible

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: Agnes Video MCP Server

✨ Why Agnes MCP?

Feature

Agnes MCP

Other AI Image Services

Price

$0 / image, $0 / second

$0.02 - $0.08 / image

Text-to-Image

βœ… 2 models (2.0 & 2.1 Flash)

βœ… Usually 1 model

Image-to-Image

βœ… Reference image + prompt

❌ or limited

Batch Generation

βœ… 1-4 images at once

❌

Text-to-Video

βœ… Up to 18s, 1080p

❌ or paid only

Image-to-Video

βœ… Static image β†’ video

❌ or paid only

Multi-image Video

βœ… Keyframe animation

❌

Auto Download

βœ… Saves locally automatically

❌ Manual download

MCP Standard

βœ… Full compliance

Varies

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"

Dragon over mountains

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

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

Ramen shop at night

πŸ“¦ Tools

Tool

Description

Example

text_to_image

Generate image(s) from text

prompt: "a cat" + optional n: 4, images: [ref_url]

image_to_image

Generate from reference image(s) + text

prompt: "make it cyberpunk" + images: [url]

text_to_video

Generate video from text/image(s)

prompt: "a cat dancing" + optional mode, num_inference_steps

image_to_video

Animate a static image into video

prompt: "zoom in slowly" + image: "url"

keyframe_animation

Smooth transition between keyframe images

prompt: "morph scene" + images: [url1, url2, ...]

check_video_status

Check async video task status

video_id: "xxx" or task_id: "xxx"

βš™οΈ Environment Variables

Variable

Required

Default

Description

AGNES_API_KEY

Yes

-

Your Agnes AI API key

AGNES_API_BASE

No

https://apihub.agnes-ai.com/v1

API base URL

AGNES_DEFAULT_MODEL

No

agnes-image-2.1-flash

Default image model

AGNES_DEFAULT_SIZE

No

1024x768

Default image size

πŸ”‘ 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

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Future Video Studio

    Create and manage cinematic AI video renders through the Future Video Studio Agent API.

  • vicsee-mcp-server

    Generate, edit and upscale AI video and images from any agent via VicSee.

  • Rendobar

    Transform video, audio and images, and generate media from prompts. FFmpeg, captions, models.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MSWEIMZ/agnes-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server