Skip to main content
Glama
gaudio-developers-mcp

gaudio-developers-mcp

Official

@gaudiolab/mcp-developers

npm version Glama score License: MIT

MCP server for Gaudio Lab Audio AI API. Separate vocals, instruments, dialogue, music, effects from any audio/video — or sync lyrics to timestamps — all through natural language in your AI tools.

Works with Claude, ChatGPT, Cursor, VS Code, GitHub Copilot, and any MCP-compatible client.

Get Your API Key

  1. Sign up at Gaudio Developers

  2. Create a project and get your API key from the dashboard

Related MCP server: IRCAM Amplify MCP Server

Quick Start

Add to your MCP client config:

{
  "mcpServers": {
    "gaudio": {
      "command": "npx",
      "args": ["-y", "@gaudiolab/mcp-developers"],
      "env": {
        "GAUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Then just ask in natural language:

  • "Separate the vocals from this file"

  • "Extract the dialogue from this video"

  • "Sync these lyrics to this song"

  • "What models are available?"

  • "How many credits do I have left?"

Tools

Tool

Description

gaudio_get_key_info

Get API key info: credits, project, permitted models

gaudio_list_models

List available AI models by category

gaudio_upload_file

Upload audio/video/text file (multipart, auto-chunked)

gaudio_create_job

Create a processing job

gaudio_get_job

Check job status and get download URLs

gaudio_separate_audio

All-in-one: upload → process → download URLs

gaudio_sync_lyrics

All-in-one lyrics sync with timestamps

Models

Stem Separation

Model

Description

Type Options

gsep_music_hq_v1

Multi-instrument separation

vocal, drum, bass, electric_guitar, acoustic_piano

gsep_music_shq_v1

Super HQ vocal + accompaniment

vocal

gsep_speech_hq_v1

Speech / noise removal

speech

Max: 1GB / 20 min per file. Types can be combined (e.g. vocal,drum).

DME Separation (Dialogue, Music, Effects)

Model

Description

gsep_dme_dtrack_v1

Dialogue extraction

gsep_dme_d2track_v1

Dialogue + vocals

gsep_dme_metrack_v1

Music + effects

gsep_dme_me2track_v1

Music + effects v1

gsep_dme_me2track_v2

Music + effects v2 (high quality)

gsep_dme_mtrack_v1

Music only

gsep_dme_etrack_v1

Effects only

Max: 10GB / 200 min per file.

AI Text Sync

Model

Description

Languages

gts_lyrics_line_v1

Lyrics line sync

en, ko, ja, zh-cn

Max: 1GB / 10 min. Text: .txt (UTF-8), min 2 lines, max 60 chars/line.

Output: CSV (timestamp, lyric_text, confidence_score) + JSON report.

Supported Formats

Type

Formats

Audio

WAV, FLAC, MP3, M4A

Video

MOV, MP4 (audio auto-extracted)

Text

TXT (UTF-8)

Output: MP3 (48kHz/320kbps) + WAV (same as input). Download URLs valid for 48 hours.

How It Works

Upload file → Create job → Poll status → Get download URLs

The high-level tools (gaudio_separate_audio, gaudio_sync_lyrics) handle this entire flow automatically. Upload IDs are valid for 72 hours and can be reused across multiple jobs.

License

MIT

Available Tools

7 tools
gaudio_create_jobA

Create a processing job with an uploaded file. For Stem Separation models (gsep_music_hq_v1, gsep_music_shq_v1, gsep_speech_hq_v1), the 'type' parameter is required (e.g. 'vocal', 'vocal,drum'). For DME models, no type is needed. For Text Sync (gts_lyrics_line_v1), use gaudio_sync_lyrics instead.

Inputs: uploadId (required), model (required), type.

gaudio_get_jobA

Check job status and get results. Status: 'waiting' (queued), 'running' (processing), 'success' (done, downloadUrl included), 'failed' (error). Download URLs expire after 48 hours.

Inputs: jobId (required), model (required).

gaudio_get_key_infoA

Get API key information: description, creation date, status, permitted models, project name, and remaining credits (free + paid).

Inputs: no named parameters.

gaudio_list_modelsA

List available Gaudio AI models. Filter by category: 'stem' (instrument separation), 'dme' (dialogue/music/effects separation), 'text_sync' (lyrics sync).

Inputs: category.

gaudio_separate_audioA

All-in-one audio separation: upload file (or reuse uploadId) → create job → poll until done → return download URLs. For Stem Separation, provide 'type' (e.g. 'vocal', 'vocal,drum'). For DME Separation, no type needed. Supports WAV, FLAC, MP3, M4A, MOV, MP4.

Inputs: model (required), filePath, uploadId, type, +1 more.

gaudio_sync_lyricsA

All-in-one lyrics sync: upload audio + text files → create gts_lyrics_line_v1 job → poll → return CSV (timestamp, lyric_text, confidence_score) + JSON report URLs. Text file requirements: .txt format, UTF-8, minimum 2 lines, max 60 characters per line. Audio limit: 1GB / 10 minutes.

Inputs: language (required), audioFilePath, audioUploadId, textFilePath, +2 more.

gaudio_upload_fileA

Upload a local audio/video/text file to Gaudio servers. Handles multipart upload automatically (create → chunk upload → complete). The returned uploadId is valid for 72 hours and can be reused across multiple jobs. Supported formats: WAV, FLAC, MP3, M4A, MOV, MP4, TXT.

Inputs: filePath (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a distinct purpose: listing models, uploading files, creating jobs, checking job status, and two all-in-one wrappers plus API key info. The manual and wrapper tools are clearly differentiated by their descriptions, with the all-in-one tools explicitly labeled as such, leaving no ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent 'gaudio_' prefix with a verb_noun pattern in snake_case (list_models, upload_file, create_job, get_job, separate_audio, sync_lyrics, get_key_info). This is highly predictable and uniform.

    Tool Count5/5

    Seven tools is well-scoped for a focused AI processing API. It covers the essential operations without unnecessary bloat, and each tool serves a clear function in the workflow, from listing models to managing jobs and retrieving results.

    Completeness5/5

    The tool set provides complete coverage for the domain: model discovery, file upload, job creation/status tracking, and two end-to-end workflows (separation and lyrics sync) plus account/key info. There are no obvious missing operations that would cause agent failures.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers