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)
| File | Size | Uploaded | |
|---|---|---|---|
| audial_mcp-0.1.0.tar.gz | 104.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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}
|