Skip to content
MCP server

ShortSmash

Turn a prompt or trending topic into a captioned vertical short and publish it

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Web, self-hosted
Runs
Locally
Version
0.3.0
Listing updated
today

Similar MCP servers

About ShortSmash

ShortSmash is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

ShortSmash builds finished 9:16 videos from one sentence or a trending topic. A language model writes a script and shot plan, a neural voice reads it, footage is gathered from Pixabay or AI video providers named in the README (Veo 3.1, Kling, Agnes), and FFmpeg renders 1080 by 1920 video with karaoke captions and music ducked under the narration.

Its distinguishing step is a vision gate: each candidate clip is checked by a local CLIP model, then by Gemini when quota allows, so mismatched stock footage is rejected. Renders with missing audio fail instead of shipping. A dub command re-voices a video in 50 languages.

Publishing goes through official APIs to platforms including YouTube, TikTok, Instagram, X, Threads, Bluesky, LinkedIn, Pinterest and Facebook, with scheduling in natural phrasing such as Friday 6pm. The same features run from a command line, a local web studio started with shortsmash serve, and an MCP server that lets agents generate videos, fetch trends and check project status.

Install

Run in a terminal

claude mcp add shortsmash -- uvx shortsmash

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shortsmash": {
      "command": "uvx",
      "args": [
        "shortsmash"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shortsmash": {
      "command": "uvx",
      "args": [
        "shortsmash"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "shortsmash": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "shortsmash"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shortsmash": {
      "command": "uvx",
      "args": [
        "shortsmash"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "shortsmash": {
      "command": "uvx",
      "args": [
        "shortsmash"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Prompt to video
Creates script, voiceover, footage, captions and a rendered short.
Vision gate
CLIP and Gemini checks reject footage that does not match the topic.
Trend harvesting
Fetches trending topics per niche to use as video ideas.
Dubbing
Re-voices a video in 50 languages.
Multi-platform publishing
Posts through official APIs and can schedule posts.
Local web studio
A browser studio for generating, browsing trends and publishing.

Good for

  • Produce a batch of shorts from the top trends in a niche
  • Re-voice one video for several languages
  • Let an agent make and schedule a short
  • Post your own video with an AI-written title and hashtags

Pricing

Open source

Open source; third-party providers may need their own keys

ShortSmash FAQ

How do I install it?

Clone the repository and run the install script, or install the shortsmash package from PyPI.

Does it use official platform APIs?

Yes. The README says publishing uses official APIs only, without scraping or browser automation.

Which language models can write scripts?

The README lists NVIDIA NIM, Gemini, Grok and any OpenAI-compatible endpoint, with an offline template fallback.

Can it run offline?

Parts can, such as Piper voices and the local CLIP check, but some providers need keys.

Is ShortSmash free?

Yes. ShortSmash is open source, so you can use and self-host it for free.

How do I add ShortSmash to Claude Code?

Run this command in your terminal: claude mcp add shortsmash -- uvx shortsmash

What are the best alternatives to ShortSmash?

The closest alternatives to ShortSmash are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and Google Ads + Meta Ads + SEO/GEO MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers