About Media Engine
Media Engine is an MCP server for generating images, video, and audio through MediaEngine for Claude, Cursor, and other MCP clients. It includes content-specific generation tools and job status operations.
Key features
- 01Generate images from text prompts
- 02Create article, email, and social graphics
- 03Generate videos and article teasers
- 04Create speech and article narration
- 05Track and list media jobs
Use cases
- 01Create hero images for articles
- 02Prepare header images for marketing emails
- 03Generate social media graphics
- 04Produce video teasers or audio narration
MCP support
It exposes MediaEngine image, video, audio, and job-management tools to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y mcp-media-engineMEDIAENGINE_API_KEYSecretYour MediaEngine API key (sign up at mcpmediaengine.com)MEDIAENGINE_BASE_URLMediaEngine API base URLLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
11Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| size | enum | No | Output image dimensions. Defaults to 1024x1024.256x256 | 512x512 | 1024x1024 |
| tone | string | No | Desired emotional tone (e.g. "professional", "playful", "urgent"). Optional. |
| title | string | No | Title of the article, email, or post. Used to derive visual style and subject. |
| summary | string | No | Short summary or body text to guide image composition. If omitted, title alone is used. |
| brand_style | string | No | Brand aesthetic descriptor (e.g. "minimalist dark", "bold colorful"). Optional. |
| aspect_ratio | string | No | Explicit aspect ratio override (e.g. "16:9", "1:1", "4:5"). Optional. |
| content_type | enum | No | Type of content this image supports (blog, newsletter, email, social). Defaults to blog.blog | newsletter | email | social |
| target_platform | enum | No | Platform this image targets, used to pick aspect ratio and style conventions.linkedin | twitter | instagram | substack | generic |
| reference_images | array | No | Optional reference images with roles (e.g. brand logo, style reference). |
Details
From the project READMEmcp-media-engine
MCP server for MediaEngine — AI-powered image, audio, and video generation for Claude, Cursor, and other MCP clients.
Tools
| Tool | Description |
|---|---|
generate_image | Generate images from text prompts — full model catalog (Nano Banana, GPT-Image) |
generate_article_hero_image | Hero banner for blog posts and articles |
generate_email_header_image | Header image for marketing emails |
generate_social_teaser_image | Social media graphics for LinkedIn, Twitter, Instagram |
generate_video | AI video generation with provider-specific params |
generate_article_teaser_video | Short teaser videos from article content |
generate_audio | Text-to-speech synthesis |
generate_article_narration | Audio narration for articles and blog posts |
wait_for_job | Poll until a media job completes |
get_job_status | Check status of a media job |
list_jobs | List media jobs with filtering and pagination |
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 |
|---|---|---|
MEDIAENGINE_BASE_URL | Yes | Your MediaEngine API base URL |
MEDIAENGINE_API_KEY | Yes | Your MediaEngine API key |
LOG_LEVEL | No | Log level (debug, info, warn, error). Default: info |
Quality Tiers
| Tier | Model | Description |
|---|---|---|
basic | Nano Banana | Fast and affordable |
standard | Nano Banana | Balanced quality (default) |
premium | GPT-Image | Highest quality — clean text rendering |
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.