# ShortSmash

> ShortSmash is an open-source MCP server for design and media. Turn a prompt or trending topic into a captioned vertical short and publish it. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/hydope/shortsmash
- **MCP Registry name:** io.github.hydope/shortsmash
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add shortsmash -- uvx shortsmash
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "shortsmash": {
      "command": "uvx",
      "args": [
        "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.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/shortsmash
