mcp-media-engine
The mcp-media-engine server provides AI-powered tools for generating images, videos, and audio, plus job management for async workflows.
Image Generation
generate_image— Generate any image from a text prompt using multiple models (DALL-E 3, Stable Diffusion, GPT-Image, etc.) with quality tiers (basic, standard, premium) and options like ControlNet and face swapgenerate_article_hero_image— Create hero banners for blog posts, CMS heroes, and newsletter headersgenerate_email_header_image— Generate wide-format headers optimized for marketing emailsgenerate_social_teaser_image— Produce social graphics optimized for LinkedIn, Twitter/X, Instagram, or Substack with auto-selected aspect ratios
Video Generation
generate_video— General AI video generation with provider-specific parametersgenerate_article_teaser_video— Create short 15–30s teaser videos from article content for YouTube Shorts, TikTok, and Instagram Reels
Audio Generation
generate_audio— Text-to-speech synthesis with multiple voices, formats (MP3, FLAC, AAC, Opus), and speed controlsgenerate_article_narration— Generate podcast-style narration of articles for audio newsletters and accessibility voiceovers
Job Management
wait_for_job— Poll until a media job completes (up to 10 minutes), returning the final resultget_job_status— Check the current status and result of any job by IDlist_jobs— List and filter jobs by type, status, date range, with sorting and pagination
All generation tools return job IDs for non-blocking operation, and support brand/style customization via tone, aspect ratio, target platform, and reference images.
Generates AI-powered images and videos optimized for Instagram, including social teaser images and article teaser videos with appropriate aspect ratios and styles for sharing on the platform.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-media-engine Generate an image of a mountain landscape with a lake."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-media-engine
MCP server for MediaEngine — AI-powered image, audio, and video generation for Claude, Cursor, and other MCP clients.
Tools
Tool | Description |
| Generate images from text prompts — full model catalog (Nano Banana, GPT-Image) |
| Hero banner for blog posts and articles |
| Header image for marketing emails |
| Social media graphics for LinkedIn, Twitter, Instagram |
| AI video generation with provider-specific params |
| Short teaser videos from article content |
| Text-to-speech synthesis |
| Audio narration for articles and blog posts |
| Poll until a media job completes |
| Check status of a media job |
| List media jobs with filtering and pagination |
Related MCP server: multimodal-mcp
Installation
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"mediaengine": {
"command": "npx",
"args": ["-y", "mcp-media-engine"],
"env": {
"MEDIAENGINE_BASE_URL": "https://your-mediaengine-instance.com",
"MEDIAENGINE_API_KEY": "your-api-key"
}
}
}
}Cursor
Add to your .cursor/mcp.json:
{
"mcpServers": {
"mediaengine": {
"command": "npx",
"args": ["-y", "mcp-media-engine"],
"env": {
"MEDIAENGINE_BASE_URL": "https://your-mediaengine-instance.com",
"MEDIAENGINE_API_KEY": "your-api-key"
}
}
}
}Configuration
Environment Variable | Required | Description |
| Yes | Your MediaEngine API base URL |
| Yes | Your MediaEngine API key |
| No | Log level (debug, info, warn, error). Default: info |
Quality Tiers
Tier | Model | Description |
| Nano Banana | Fast and affordable |
| Nano Banana | Balanced quality (default) |
| GPT-Image | Highest quality — clean text rendering |
License
MIT
Available Tools
11 toolsgenerate_article_hero_imageA
Generate a hero banner image for a blog post, article, or editorial page. Creates an AI-generated visual from the title and summary — ideal for CMS hero banners, newsletter headers, and article thumbnails. Use this when you need to create a featured image, hero graphic, or cover illustration for written content. Supports brand style hints and reference images.
Inputs: size, tone, title, summary, +5 more.
generate_article_narrationA
Generate audio narration of article or blog post content using text-to-speech. Creates podcast-style audio, accessibility voiceovers, and audio newsletters from written text. Pass the article title and body text; the tool selects an appropriate voice and submits an async audio job. Returns a job ID to poll for the finished audio file.
Inputs: text, speed, title, voice, +1 more.
generate_audioA
Generate audio from text using text-to-speech (TTS) synthesis. Create voiceovers, narrations, podcast audio, or any spoken audio from text input. Supports multiple voices (alloy, echo, fable, onyx, nova, shimmer), formats (MP3, FLAC, AAC, Opus), and playback speeds. Use the intent-specific generate_article_narration tool for article content.
Inputs: text (required), speed, voice, format.
generate_email_header_imageA
Create an AI-generated header image for marketing emails and newsletters. Optimised for wide-format email banners (typically 600px wide) from subject line and body text. Accepts tone and brand_style hints to stay on-brand. Returns a queued media job whose result URL can be embedded in the email template. Use this to create email graphics, newsletter banners, or promotional header visuals.
Inputs: size, tone, title, summary, +5 more.
generate_imageA
Generate an image from a text prompt using the MediaEngine model catalog. Use this for any image creation request: illustrations, photos, AI art, logos, icons, graphics, or visuals. Accepts a raw prompt and optional aspect ratio, quality tier, model id, and advanced style parameters. Quality tiers: basic/standard (Nano Banana — fast, inexpensive default), premium (GPT-Image — strongest prompt adherence and clean text rendering). One integration, every model: new models are added to the catalog server-side, so the same wiring keeps working. Style guidance: put the desired look in the prompt itself (e.g. "black and white archival photograph", "flat vector illustration") and bake negatives into the prompt ("no text, no words, no logos"). Use the intent-specific tools (generate_article_hero_image, etc.) when you know the content type.
Inputs: prompt (required), size, model, quality, +13 more.
generate_videoA
Generate a video using AI video generation. Use this for any video creation request when the intent-specific video tools do not fit. Accepts provider-specific generation parameters directly.
Inputs: inputParams (required), provider.
get_job_statusA
Get the status and result of a media job by its ID.
Inputs: jobId (required).
list_jobsA
List media jobs with optional filtering, sorting, and cursor-based pagination.
Inputs: page, sort, type, limit, +6 more.
wait_for_jobA
Wait for a media generation job to complete — polls until the image, video, or audio is ready or the timeout is reached. Use this to get the final result without manually calling get_job_status in a loop. Returns the completed job on success or an error if the timeout expires.
Inputs: jobId (required), timeoutSeconds.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Tools are generally distinct with specific intent-based variants (e.g., generate_article_hero_image vs. generate_image). Overlap exists between general and specific generators, but descriptions clearly guide usage, reducing confusion.
All tool names follow a consistent verb_noun pattern (generate_*, get_*, list_*, wait_for_*). No mixing of conventions, making the set predictable.
11 tools cover the core media operations (generate images, audio, video in general and specific forms, plus job management) without being excessive. Scope is well-balanced.
The tool set covers generation and job lifecycle (status, listing, waiting). Missing delete/abort jobs is minor. Specific media types (article, email, social) are well-represented, leaving few gaps.
Maintenance
Related MCP Connectors
MCP server for Wan AI video generation
MCP server for Qwen Image 3 AI image generation
MCP server for Google Veo AI video generation
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for the XBrush AI media generation API, enabling image, video, audio generation, editing, and more directly from Claude Code via async polling.2118 npmMIT
- AlicenseAqualityDmaintenanceMulti-provider media generation MCP server that generates images, videos, audio, and transcriptions from text prompts using OpenAI, xAI, Gemini, ElevenLabs, and BFL through a single unified interface.6169 npm2MIT
- AlicenseAqualityDmaintenanceOpen-source MCP server for AI image and video creation, enabling prompt library search, prompt enhancement, and media generation from Claude Code, Cursor, and other MCP hosts.8MIT
- AlicenseAqualityCmaintenancemediamcp is an MCP server that connects your AI assistant — Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, or anything else that speaks MCP — to cloud media models (Gemini Flash Image, GPT-5 Image, Seedream, Veo, Sora, …) via OpenRouter or any OpenAI-compatible API.674 npm4MIT