Mediagen MCP server

mediagen — an image and video generation skill for coding agents

Give your agent image and video generation across Google Gemini, OpenAI and Kie AI — one skill, one install, no API to learn.

Say roughly what you want and let it decide the rest:

You:   Make a hero image for the landing page, wide, something moody and industrial.

Agent: npx -y mediagen image "A disused loading dock at dusk, wet concrete…"
         --aspect-ratio 21:9 --json
       → ./output/image-20260823T094107Z.png

It wrote the prompt out in full, knew 21:9 rules OpenAI out, and read the path back from --json.

Or be exact, and it stops deciding:

You:   Same thing with gemini-3-pro-image, 21:9, 4K, marked as AI-generated,
       saved as hero.png.

Agent: npx -y mediagen image "A disused loading dock at dusk, wet concrete…"
         --model gemini-3-pro-image --aspect-ratio 21:9 --size 4K
         --output-name hero.png --json
       → ./output/hero.jpg

       [looks at the image]

       npx -y mediagen mark ./output/hero.jpg --visible-label
         --label-position top-right --json
       → ./output/hero.labelled.jpg

It marked in a second pass, after seeing where the subject ended up — and put the label on the flat roofline rather than over the loading bay.

Anything the CLI takes can be asked for in words — provider, model, aspect ratio, size, output name and directory, quality preset, video duration, an input image to edit, and whether to mark the result. Name any of them and the agent uses it as given; leave it out and it chooses, or falls back to what you configured.

Install

npx -y skills add Cripacx/mediagen --skill mediagen

That is the whole installation. Nothing else to set up — the skill runs the CLI through npx, which fetches it on first use and caches it afterwards.

Then give it a key:

npx -y mediagen init

An interactive wizard: pick providers, enter each key without it being echoed, verify each against the live API, choose a model per provider, and set a default. One key is enough to start.

Now just ask your agent for an image.

What your agent can do with it

have

• Generate images and video from a description, or edit media you already

21:9 and video, that OpenAI cannot do 16:9 at all, and that Kie aggregates around thirty third-party models

• Choose the right provider for the task — the skill knows Gemini handles

ratio, a size or a filename and it is used as stated. mediagen models is there when you want to see what is available before choosing

• Take your instructions literally when you give them. Name a model, a

"a hero image, moody and industrial" becomes a full description of subject, composition, light, camera and materials before anything is sent

• Write the prompt properly. The skill carries prompt-writing guidance, so

anything photorealistic or destined for publication

• Mark AI-generated output when it matters — the skill suggests it for

machine-readable code and a next action

• Recover from failures on its own, because every error carries a

And what it will not do: ask you to paste an API key into the chat. On a configuration error the skill tells you to run mediagen init in your own terminal.

Prerequisites

and video, widest range of shapes

• At least one API key:
• Google Gemini (get one here) — images

• OpenAI (get one here) — images
• Kie AI (get one here) — ~30 third-party models
• Node.js 20.11 or later

Configuration

Shortened. The full README is on GitHub.