Chutes Media MCP server

chutes-media-mcp

Generate image, video, music and speech through Chutes from inside any coding agent — Claude Code, Cursor, Cline, Windsurf, Codex, OpenCode, Claude Desktop — and save the generated asset straight into the project you're working on.

Independent community project. Not officially affiliated with or endorsed by Chutes.

Quick start

Requires Node.js 20.3+ and a Chutes API key. Add the server to Claude Code:

claude mcp add chutes-media --env CHUTES_API_KEY=cpk_your_key -- npx -y chutes-media-mcp

Then ask your agent naturally:

Generate a cinematic hero image of a misty mountain range and save it in this project.

The agent discovers a suitable model, reads its live input schema, validates the request, and saves the result under assets/chutes//. For Cursor, Cline, Windsurf, OpenCode and Claude Desktop, see Use as an MCP server.

Why chutes-media-mcp?

It ships as:

describe→generate workflow (auto-loaded by Claude Code; usable as reference by any agent).

• an MCP server (chutes-media-mcp, stdio) — the primary, universal interface,
• a thin CLI (chutes-media) — a fallback for shells and agents without MCP support, and
• an optional Agent Skill (skill/chutes-media) documenting the

Both frontends are thin adapters over one shared, transport-agnostic core.

Features

when a model exposes an edit cord.

• 🎨 Four media kinds: image, video, music, speech — plus image editing (img2img / inpaint)

payloads are never hardcoded.

• 🔎 describe → generate workflow: the live model schema is fetched and handed to the agent;

rejects unknown params, and verifies the returned media type matches what you asked for.

• 💾 Saves assets into your project (default ./assets/chutes//) and returns the path.
• ✅ Validates the payload against the live schema before spending a GPU call.
• 🧾 Provenance + guardrails: writes a sidecar (model, params, schema hash) next to each asset,

• 🔁 Automatic cold-start retry with backoff for models scaled to zero.
• 📡 Progress updates during long video/music jobs (MCP progress notifications / CLI stderr).
• 🧩 Works everywhere: MCP server or CLI, same behavior.

How it works: describe → generate

Shortened. The full README is on GitHub.