Skip to main content

audial-mcp

Run Audial's hosted audio tools from any MCP client: split stems, analyze and segment audio, master tracks, build sample packs, convert audio to MIDI, generate music, turn a one-shot into an editable Audial Synth preset, and sing lyrics in a reference voice.

mcp-name: io.github.AudialAI/audial-mcp

Install

You need an Audial account (user id + API key from https://audialmusic.ai) and uv.

Claude Code

claude mcp add audial \
  -e AUDIAL_USER_ID=your-user-id -e AUDIAL_API_KEY=your-api-key -e AUDIAL_RESULTS_DIR=~/Audial \
  -- uvx audial-mcp

Claude Desktop / Cursor / any client with a JSON config

{
  "mcpServers": {
    "audial": {
      "command": "uvx",
      "args": ["audial-mcp"],
      "env": {
        "AUDIAL_USER_ID": "your-user-id",
        "AUDIAL_API_KEY": "your-api-key",
        "AUDIAL_RESULTS_DIR": "~/Audial"
      }
    }
  }
}

Tools

Tool What it does
stem_split Split a track into vocals, drums, bass, other (optionally retime / rekey)
analyze BPM, key and other characteristics
segment Sections and component analysis
master Mastering, optionally matched to a reference
generate_samples Sample pack from a track
generate_midi Audio to MIDI
generate_music Text to music, covers, remixes, extraction, completion with the Audial music model
sound2vital One-shot → editable Audial Synth (Vital) preset
text2vox Lyrics + reference voice → sung vocal and MIDI
list_results Browse previous results in your results folder

What leaves your machine

Audio and text you pass to a tool are uploaded to Audial's API (https://api.audialmusic.ai) over HTTPS and processed on Audial's servers; results are downloaded into AUDIAL_RESULTS_DIR (default ~/Audial). Nothing else is sent.

Two other files are read if they exist, because the Audial SDK looks for them: ~/.audial/.audial_config.json and a .env in the directory the server was started from. Credentials from your MCP client's config always win: audial-mcp snapshots its environment before the SDK loads either file, so neither can redirect your credentials or the API host.

Some tools require an active Audial subscription; the tool tells you when that is the case.

Configuration

Variable Required Default
AUDIAL_USER_ID yes
AUDIAL_API_KEY yes
AUDIAL_RESULTS_DIR no ~/Audial
AUDIAL_JOB_TIMEOUT_S no 900
AUDIAL_API_BASE_URL no production API

License

MIT. Source: https://github.com/AudialAI/audial-mcp

Release files for audial-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for audial-mcp 0.1.0
File Size Uploaded
audial_mcp-0.1.0.tar.gz 104.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for audial-mcp 0.1.0
File Interpreter ABI Platform
audial_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 121.7 kB

Release files / audial_mcp-0.1.0.tar.gz

Download URL audial_mcp-0.1.0.tar.gz
Size 104.7 kB
Tags Source
SHA-256 checksum
How to use checksums
e4ed4537e1a038fdb1f98b5449fa95d3eb6681f4a57c96ea61eec315b135bf02
BLAKE2b-256 checksum
How to use checksums
e8a528db427a036db2bb54086dbcf20dde46d360851160703e5905cac13a21f9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / audial_mcp-0.1.0-py3-none-any.whl

Download URL audial_mcp-0.1.0-py3-none-any.whl
Size 17.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4e62f49b6168c894027db6a796b715ba3733366fb9e344a7a1f796472c221878
BLAKE2b-256 checksum
How to use checksums
822a00c9b056e0627b847f16f94e1891ecf24a4807f4d0522bd824f464bcf8fd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

0.1.1

2 release files

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page