Skip to content
MCP server

ismail

Open-source DAW your agent drives over MCP, hearing renders as text

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.4.5
Listing updated
3 days ago

About ismail

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

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.

Install

Run in a terminal

claude mcp add ismail -- uvx ismail

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free, MIT license

Prices change. Check measuredinstruments.com before you buy.

ismail 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 to ismail

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media