audial-mcp
Powered by Audial — 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. See the API reference for details on what each tool calls.
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 -- splits stems, then segments them; one call |
master |
Mastering, optionally matched to a reference |
generate_samples |
Sample pack from a track -- splits stems, then builds the pack; one call |
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 |
pipeline_status |
Look up a pipeline by id: its state, each step, and the outputs so far |
list_results |
Browse previous results in your results folder |
segment and generate_samples run as Audial pipelines: both need separated stems, so the
API splits stems and then runs the step you asked for as one job. Each step is reported as it
starts and finishes ("stem-split completed in 41 s; sample-pack running"), and the pipeline id
comes back as the result's execution_id -- pass it to pipeline_status to check on a job
whose call timed out.
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.
Every tool except list_results calls the Audial API, which requires an active Audial subscription on the account; without one the tool returns the API's subscription message.
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
Metadata
Release files for audial-mcp 0.2.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 | Provenance | Actions |
|---|---|---|---|---|
| audial_mcp-0.2.0.tar.gz | 109.9 kB | Without provenance | Details for audial_mcp-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| audial_mcp-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for audial_mcp-0.2.0-py3-none-any.whl |
Total release size: 129.9 kB
Release files / audial_mcp-0.2.0.tar.gz
| Download URL | audial_mcp-0.2.0.tar.gz |
|---|---|
| Size | 109.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c645686eba183a52ffa79002a09b715df730f2af86d281c79c736614215e94e0
|
|
BLAKE2b-256 checksum How to use checksums |
825d502ca80f97af5a7c5db6e7e3adceaa71d4b178c17c382a986e9bb13d95b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / audial_mcp-0.2.0-py3-none-any.whl
| Download URL | audial_mcp-0.2.0-py3-none-any.whl |
|---|---|
| Size | 20.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bdd7e84227670ba5f16b42ba650ce01788711882ddc1da91a1d3947f9703550d
|
|
BLAKE2b-256 checksum How to use checksums |
fcb63cd294741c42ceb79b32ebc06edb333f53015f5abd81dabf2f2e149fd92b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Security for audial-mcp 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.