gitwtfhub

wtf is chutes-media-mcp?

thestreamcode/chutes-media-mcp — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

An MCP server and CLI that lets AI coding assistants generate images, video, music, and speech through Chutes, with assets saved directly into the current project folder.

Mindmap

mindmap
  root((chutes-media-mcp))
    What it does
      Generate images
      Generate video
      Generate music and speech
    How it works
      Describe model schema first
      Then generate
      Saves to project folder
    Access methods
      MCP server
      CLI fallback
      Agent skill doc
    Setup
      Node.js 20 plus
      Chutes API key
      MIT license

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Have an AI coding agent generate a hero image for a landing page and save it directly into the project assets folder.

REASON 2

Use Claude Code to generate background music for a web project without leaving the coding environment.

REASON 3

Generate text-to-speech audio for a script file directly from the CLI as part of a build or content pipeline.

What's in the stack?

TypeScriptNode.jsMCP

How it stacks up

thestreamcode/chutes-media-mcp0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires a Chutes API key from chutes.ai.

Use freely for any purpose including commercial projects as long as you keep the copyright notice.

Wtf does this do

This is a tool that lets AI coding assistants like Claude Code, Cursor, and Cline generate media files directly inside the project they are working on. The supported media types are images, video, music, and speech. A generated image or audio clip is saved as an actual file in the project folder, so the agent can immediately reference it in code, an HTML page, or anywhere else in the codebase. The tool runs as an MCP server, which is a standard way for AI coding tools to access external capabilities. You register it once in your coding tool's configuration with a Chutes API key, and from that point the agent can discover, describe, and invoke media generation models without manual steps. The workflow follows a describe-then-generate pattern. Because different image and audio models accept completely different settings, the tool first fetches the live input specification for whichever model the agent wants to use. The agent reads that specification and builds the correct request, then sends it. This means the tool never hardcodes parameters for a specific model and stays correct as models are updated. Generated files land in an assets folder inside the current project by default. A small sidecar file is written alongside each asset recording which model was used, what parameters were passed, and a hash of the model's schema at generation time. Unknown or misspelled parameters are rejected before a generation call is made, so mistakes fail early rather than silently. There is also a standalone command-line interface for use in shells and environments that do not support the MCP protocol. Installation is via npm and requires Node.js 20 or later and a Chutes API key. The license is MIT.

Yoink these prompts

Prompt 1
How do I add chutes-media-mcp to Claude Code so my agent can generate images and save them into my project? Show me the exact claude mcp add command.
Prompt 2
I want my AI coding agent to generate a hero image for my landing page. Walk me through the describe then generate workflow using the chutes-media MCP tools.
Prompt 3
How do I use the chutes-media CLI to list available music generation models and generate a short background track from a text prompt?
Prompt 4
What does the provenance sidecar file that chutes-media-mcp writes contain, and how do I disable it if I don't want extra files next to my assets?

Frequently asked questions

wtf is chutes-media-mcp?

An MCP server and CLI that lets AI coding assistants generate images, video, music, and speech through Chutes, with assets saved directly into the current project folder.

What language is chutes-media-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

What license does chutes-media-mcp use?

Use freely for any purpose including commercial projects as long as you keep the copyright notice.

How hard is chutes-media-mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is chutes-media-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.