# ismail

> ismail is an open-source MCP server for design and media. Open-source DAW your agent drives over MCP, hearing renders as text. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://measuredinstruments.com/ismail/
- **Repository:** https://github.com/newsbubbles/ismail
- **MCP Registry name:** io.github.newsbubbles/ismail
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

ismail starts from the fact that an agent cannot hear. Every render is read back as text: levels per bar, drum patterns, chords, a piano roll and a bar-by-bar view of song form, plus comparisons against a reference. Songs are code, so asking to change bar 12 changes only bar 12. It mixes and masters to a requested loudness, handles MIDI in and out, and can play live from decks or jams.

The site says no generative audio model makes the sound and renders are lossless 24-bit WAV. It also describes a VR stage that agents build while you stand in it, and a phone page that lets you talk back through earbuds while the agent adds its own panels.

It is MIT-licensed and runs on your own machine with Python 3.10 or newer: `pip install ismail`, or `uvx --python 3.12 ismail mcp` for MCP clients. The README's first call for an agent is `guide`, and `ops_find` locates tools by need.

## Features

- **Renders as text:** Levels per bar, drums, chords and piano roll returned for the agent to read.
- **Song as code:** Edit one bar without touching the rest.
- **Mixing and mastering:** Mix and master to a requested loudness.
- **MIDI and live play:** Take MIDI in and out, play sets on decks or jam from parts.
- **VR stage:** A scene agents build while you stand in it, in a headset or browser.
- **Phone page:** Listen away from the desk and send voice notes on a beat.

## Good for

- Compose a loop by describing it to an agent
- Get a written mix critique after each render
- Compare a track against a reference song
- Play a live set built by an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add ismail -- uvx ismail
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `guide`: The first tool call for an agent, giving usage guidance.
- `ops_find`: Find any tool by what you need.
- `project_new`: Create a project with tempo and length.
- `track_add`: Add a track with an instrument.
- `notes_write`: Write notes to a track.
- `render`: Render the project and report levels as text.

## FAQ

### Which licence is it under?

MIT, per the site; it is free and open source.

### What does it need to run?

Python 3.10 or newer, installed with pip or run with uvx; it runs locally.

### Does it use an AI audio model?

The site says no generative audio model makes the sound.

### How do I add it to an MCP client?

Use `uvx --python 3.12 ismail mcp`.

### Is ismail free?

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

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

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

### What are the best alternatives to ismail?

The closest alternatives to ismail are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium 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.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

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