Back to Browse

Audial MCP Server

Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Audial audio tools: stems, analysis, mastering, sample packs, MIDI, music generation, vocals.

About

Audial audio tools: stems, analysis, mastering, sample packs, MIDI, music generation, vocals.

Security Report

5.2
Moderate5.2Moderate Risk

This is a well-architected MCP server with strong security practices. Authentication is properly required and enforced, credentials are handled carefully (redacted from outputs, stored in environment variables, protected from environment mutations), and dangerous patterns are absent. The codebase shows good input validation, error handling, and secure path traversal prevention. Permissions are appropriate for the server's purpose of calling the Audial music API and managing local audio files. Supply chain analysis found 3 known vulnerabilities in dependencies (1 critical, 0 high severity). Package verification found 1 issue.

6 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Audial user idOptional

Environment variable: AUDIAL_USER_ID

Audial API keyRequired

Environment variable: AUDIAL_API_KEY

Folder results are written toOptional

Environment variable: AUDIAL_RESULTS_DIR

Seconds to wait for a job before giving upOptional

Environment variable: AUDIAL_JOB_TIMEOUT_S

Override the Audial API base URL (advanced)Optional

Environment variable: AUDIAL_API_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-audialai-audial-mcp": {
      "env": {
        "AUDIAL_API_KEY": "your-audial-api-key-here",
        "AUDIAL_USER_ID": "your-audial-user-id-here",
        "AUDIAL_RESULTS_DIR": "your-audial-results-dir-here",
        "AUDIAL_API_BASE_URL": "your-audial-api-base-url-here",
        "AUDIAL_JOB_TIMEOUT_S": "your-audial-job-timeout-s-here"
      },
      "args": [
        "audial-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

ToolWhat it does
stem_splitSplit a track into vocals, drums, bass, other (optionally retime / rekey)
analyzeBPM, key and other characteristics
segmentSections and component analysis
masterMastering, optionally matched to a reference
generate_samplesSample pack from a track
generate_midiAudio to MIDI
generate_musicText to music, covers, remixes, extraction, completion with the Audial music model
sound2vitalOne-shot → editable Audial Synth (Vital) preset
text2voxLyrics + reference voice → sung vocal and MIDI
list_resultsBrowse 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.

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

VariableRequiredDefault
AUDIAL_USER_IDyes
AUDIAL_API_KEYyes
AUDIAL_RESULTS_DIRno~/Audial
AUDIAL_JOB_TIMEOUT_Sno900
AUDIAL_API_BASE_URLnoproduction API

License

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

Reviews

No reviews yet

Be the first to review this server!