Developer API

MCP Server

The Mozonic MCP server exposes your audio production tools — mix analysis, DSP correction, stem sessions, and mastering — directly to AI coding agents. Connect Cursor, Claude, or any MCP-compatible host and let your agent drive the full production workflow.

Pro plan requiredOAuth 2.0 + PKCEPython MCP server

Connect your AI tool

One-click setup for the major MCP clients. Claude, ChatGPT, and Gemini register automatically; Cursor installs via a one-click link.

Cursor

One-click install — opens Cursor and adds the Mozonic MCP server.

Add to Cursor

Claude

Opens Claude’s “Add custom connector” dialog, pre-filled. Registration is automatic.

Add to Claude

ChatGPT

Create a connector in ChatGPT (developer mode / Connectors) using this server URL.

https://mcp.mozonic.com/mcp

Gemini

Add Mozonic to the Gemini CLI with one command. Registration is automatic.

gemini mcp add --transport http mozonic https://mcp.mozonic.com/mcp

Tool Surfaces

Mozonic MCP includes multiple tool surfaces for different use cases. Most users should use the default Workflow surface, which provides everything needed for mix analysis, mastering, stem sessions, and project management.

Configure the active surface using the MOZONIC_MCP_TOOL_SURFACE environment variable.

Surface	Tools	Includes	Use case
`workflow`default	10 tools	Mix analysis Mix correction Mastering Stem session workflows Chat and account tools	Recommended for most users — Cursor, Claude, and ChatGPT
`advanced`	19 tools	Everything in Workflow PDF exports ZIP stem imports Recovery and maintenance tools Advanced support workflows	Power users, support workflows, and bulk operations
`full`	54+ tools	Everything in Advanced Legacy compatibility tools Intended for migration and power users	Compatibility and migration scenarios

Safety note

The Advanced and Full tool surfaces include destructive operations such as deleting mixes, mastering jobs, and stem sessions. These actions affect only your own Mozonic account, but deletions may be permanent and cannot always be undone.

Most users should use the default Workflow surface unless they specifically need recovery, maintenance, or bulk-management tools.

Workflow (Recommended)↓Advanced (Includes destructive tools)↓Full (Compatibility / legacy only)

Orchestration Tools

High-level tools that manage the full upload → process → poll → download pipeline in a single call. Start here — these are the preferred tools for agent workflows.

mozonic_mix_analyzeworkflow

preparerunstatus

Upload and analyze a stereo mix end-to-end. Handles the full upload pipeline: prepare presigned URL, PUT to S3, trigger analysis, then polls until analysis is complete.

Example prompt

“Upload my_mix.wav, analyze it, and tell me what needs fixing”

Parameter	Type	Notes
phase	prepare \| run \| status	default: run
filename	string	required for prepare
s3_key	string	required for run
wait	boolean	poll until complete, default true
max_wait_seconds	integer	default 120

mozonic_mix_correctworkflow

runstatus

Queue DSP autofix on an already-analyzed mix. Requires analysis to be complete first. Returns a presigned download URL when the corrected file is ready.

Example prompt

“Apply DSP autofix to my analyzed mix and give me a download link”

Parameter	Type	Notes
mix_id	string	required
phase	run \| status	default: run
wait	boolean	poll until download.url is ready, default true
max_wait_seconds	integer	default 120

mozonic_master_trackworkflow

preparerunstatus

Full mastering pipeline in a single tool. Orchestrates prepare → PUT to S3 → session start → render → polls until the mastered file is ready for download.

Example prompt

“Master this track for streaming with the loud_streaming profile”

Parameter	Type	Notes
phase	prepare \| run \| status	default: run
filename	string	required for prepare
target_profile	streaming_default \| loud_streaming \| club_loud \| commercial_loud \| podcast \| custom	default: streaming_default
queue_render	boolean	auto-render after start, default true
wait	boolean	poll until download.url is ready, default true

Granular Workflow Tools

Step-level tools that give agents precise control over each phase of a workflow. Each multi-action tool takes an action parameter. Click a tool to expand its parameters.

Advanced Surface Tools

Available when MOZONIC_MCP_TOOL_SURFACE=advanced. These tools cover recovery flows, bulk imports, delete operations, and debugging utilities.

mozonic_billing_subscription

Plan tier, usage, and feature flags for debug/support.

mozonic_mix_delete

Permanently delete a mix.

mozonic_stem_session_delete

Permanently delete a stem session.

mozonic_mastering_delete

Permanently delete a mastering session.

mozonic_stem_zip_import

Import stems from a ZIP file — recovery path for large stem sets.

mozonic_stem_classify_uploads

Classify uploaded stem paths to get suggested names and roles before session creation.

mozonic_chat_thread

Threaded persistent chat with list, create, messages, and send actions.

mozonic_mix_report_pdf

Download mix analysis report as base64-encoded PDF.

mozonic_task_dismiss

Dismiss a completed task from the notification tray.

Authentication

1OAuth 2.0 + PKCE

The remote MCP server uses OAuth 2.0 with PKCE. When you first connect, your MCP host opens a browser consent page to authorize the connection. No credentials are stored in your config.

Authorization:https://app.mozonic.com/oauth/mcp/authorize

Token:https://api.mozonic.com/oauth/token

Well-known:https://api.mozonic.com/.well-known/oauth-authorization-server

2Pro Plan Required

All MCP tools require an active Mozonic Pro subscription. This is enforced at two points: when you connect via OAuth, and on each individual tool call. Agents will receive a clear error if the plan requirement is not met.

View pricing plans

Connection Details

MCP Host URL

https://mcp.mozonic.com/mcp

Transport (stdio)

uvx mozonic-mcp

Default tool surface

workflow

Poll interval (default)

3s / 120s max