AVIZ for AI agents

Ask your own agent for a scene in plain words. It picks effects, ties them to the bass, the kick and the drop, and gives you a link that opens the scene in AVIZ. No account and no upload: the whole scene is inside the link.

How it works

1. The agent looks through the 114 effects and 117 templates of the AVIZ library and picks what fits your words.
2. It builds the scene and checks it with the same code the app uses to open links. If a value is off, it gets an exact error and fixes it.
3. It renders a preview frame on your computer to see the result, then gives you the link. Open it in the browser or in AVIZ for Mac, and play any track through it.

Set it up

The server runs on your computer through npx (Node.js 22 or later). For Claude Code, one command:

claude mcp add aviz -- npx -y aviz-mcp

Claude Desktop (Settings → Developer → Edit Config), Cursor (~/.cursor/mcp.json), Windsurf, Cline, LM Studio and other clients that run local MCP servers:

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

VS Code with GitHub Copilot, Gemini CLI, OpenAI Codex, Zed and JetBrains AI Assistant take the same command, npx -y aviz-mcp; each one’s exact setting is in the package README.

Previews need Google Chrome, Chromium or Edge; short MP4 previews also need ffmpeg. ChatGPT connects only to remote servers, so it needs a local bridge for now.

Try it

Make a dark techno scene at 128 BPM that explodes on the drop, show me a preview, and give me the link.

The agent put a red and violet laser show in stage smoke under a supernova that goes off on the drop, added a red flash with a shake on the drop and a glow on top. The first preview of the drop was a white-out, so it toned the flashes down, looked again and returned the link.

What the agent can do

• list_effects — every effect with its parameters, ranges, options and default music bindings
• list_templates, get_template — the ready-made scenes as a starting point
• build_scene — a checked scene and its link, or errors that say what to change
• preview — a PNG frame or a short MP4 rendered by the real AVIZ engine on a synthetic beat

Any number parameter can follow the bass, mids, highs, loudness, the kick, the drop, the energy or the tempo of the track; a choice can switch on every beat or on the drop.

Nothing leaves your computer

The server is local and talks to no AVIZ service. The scene travels after the # in the link, which browsers never send to a server. Preview files carry no metadata.

Package and setup for every client · Open AVIZ