# AVIZ

> AVIZ is an open-source MCP server for design and media. MCP server that lets AI agents build audio-reactive music visual scenes as shareable links. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, macOS, CLI, API
- **Website:** https://aviz.studio/agents/
- **MCP Registry name:** io.github.volodymyrslipak/aviz-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [music creation](https://ai-powered.com/categories/music-creation)
- **Listing updated:** 2026-11-20

## About

The README and site describe this as a local MCP server that turns plain-language requests into music visuals. An agent picks from a library of 114 effects and 117 templates, binds parameters to the bass, kick, drop, energy or tempo of a track, and returns a link that opens the scene in the browser or in AVIZ for Mac.

Before returning a link, the agent checks the scene against the same code the app uses to open links, and it can render a PNG or short MP4 preview on the user's computer to review the result. The server runs locally through npx on Node.js 22 or later and, per the site, talks to no AVIZ service; the whole scene is encoded in the link after the # so nothing is uploaded.

It suits people who already work in an AI assistant such as Claude, Cursor or VS Code and want to generate light shows or visual accompaniment for electronic music without opening a visual editor. Previews require Google Chrome, Chromium or Edge, and short MP4 previews also need ffmpeg.

## Features

- **Plain-language scene building:** Describe the look and rhythm you want and the agent assembles a scene from the effect library.
- **Audio-reactive parameter binding:** Number parameters can follow bass, mids, highs, loudness, kick, drop, energy or tempo.
- **Checked scene links:** Built scenes are validated and return exact errors when a value needs changing before a link is given.
- **Local preview rendering:** The preview tool renders a PNG frame or short MP4 on a synthetic beat to check the result.
- **No account or upload:** Scenes live entirely inside the shareable link, and the server talks to no AVIZ service.

## Good for

- Generating a visual scene for a dark techno or electronic track from a chat prompt
- Sharing a music visual as a single link that opens in the browser or AVIZ for Mac
- Prototyping light show ideas by previewing frames before committing to a scene
- Starting from ready-made templates and adjusting them to a track's tempo

## Install

### Claude Code (Terminal)

```sh
claude mcp add aviz-mcp -- npx -y aviz-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "aviz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "aviz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "aviz-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "aviz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "aviz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aviz-mcp"
      ]
    }
  }
}
```

## Tools

- `list_effects`: Lists every effect with its parameters, ranges, options and default music bindings.
- `list_templates`: Lists the ready-made scenes available as a starting point.
- `get_template`: Retrieves a single ready-made scene template.
- `build_scene`: Builds a checked scene and its link, or returns errors describing what to change.
- `preview`: Renders a PNG frame or short MP4 of the scene using the AVIZ engine on a synthetic beat.

## FAQ

### How do I install the server?

The site says it runs locally through npx with Node.js 22 or later. For Claude Code the command is claude mcp add aviz -- npx -y aviz-mcp, and other clients take an equivalent mcpServers entry.

### Does ChatGPT work with AVIZ?

The site says ChatGPT connects only to remote servers, so using this server with ChatGPT currently needs a local bridge.

### Are scenes uploaded anywhere?

The site says the server is local, talks to no AVIZ service, and that the scene travels after the # in the link, which browsers do not send to a server.

### What is needed for previews?

Previews need Google Chrome, Chromium or Edge. Short MP4 previews also need ffmpeg.

### Is AVIZ free?

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

### How do I add AVIZ to Claude Code?

Run this command in your terminal: claude mcp add aviz-mcp -- npx -y aviz-mcp

### What are the best alternatives to AVIZ?

The closest alternatives to AVIZ are Audio Studio, Vibresia, VibeCreator, Verse and Levea — Autonomous AI Video Editor (37 Tools, 280+ Caption Templates, OAuth 2.1).

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Audio Studio](https://ai-powered.com/mcp/audio-studio): Audio Studio is an open-source MCP server for design and media.
- [Vibresia](https://ai-powered.com/mcp/vibresia): Vibresia is a free MCP server for design and media.
- [VibeCreator](https://ai-powered.com/mcp/vibecreator): VibeCreator is a freemium MCP server for design and media.
- [Verse](https://ai-powered.com/mcp/verse): Verse is an MCP server for design and media.
- [Levea — Autonomous AI Video Editor (37 Tools, 280+ Caption Templates, OAuth 2.1)](https://ai-powered.com/mcp/levea-autonomous-ai-video-editor-37-tools-280-caption-templa-5): Levea — Autonomous AI Video Editor (37 Tools, 280+ Caption Templates, OAuth 2.1) is a freemium MCP server for video editing.
- [Brilliant Design (hosted)](https://ai-powered.com/mcp/brilliant-design-hosted): Brilliant Design (hosted) is a freemium MCP server for design and media.
- [SeedanceAI MCP](https://ai-powered.com/mcp/seedanceai-mcp): SeedanceAI MCP is an open-source MCP server for design and media.
- [Zpup](https://ai-powered.com/mcp/zpup): Zpup is an open-source MCP server for design and media.

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