denisok-ai/magicmaster-mcp

Remote MCP server that lets Claude, ChatGPT, Cursor, VS Code, Claude Code, OpenAI Codex and any other MCP client **master audio**: hit a loudness (LUFS) target with True Peak limiting, remove the **Suno / Udio AI fingerprint**, compare presets on a 24-second preview, and master a whole album with consistent relative loudness. Results come back with measured numbers and a mastering passport in the chat.
- Server: https://magicmaster.pro/mcp (streamable HTTP; protocol revisions 2026-07-28, 2025-11-25, 2025-06-18)
- OAuth endpoint (for clients that cannot send headers, e.g. Claude Desktop custom connectors): https://magicmaster.pro/mcp/oauth
- Agent playbook: · machine manifest: · OpenAPI (public subset):
- Human page (RU/EN):
- Service version: 3.15.0 (as reported by get_service_info)
Nothing to install: the server is hosted. This repository holds the connection recipes and a small stdio bridge for clients that cannot speak HTTP.
Tools
The server exposes 11 tools. Descriptions below are condensed from the live tools/list; the live text is authoritative.
| Tool | What it does | Cost |
|---|---|---|
| get_service_info | What Magic Master does, what is free, what costs a token, and where the rules live. Call once at the start of a session. | free |
| list_presets | All 24 mastering presets with their target loudness in LUFS. Gives the exact keys that master_track and batch_master accept. | free |
| get_pricing | Live token packs and payment methods (RUB). Prices are read live, not quoted from memory. | free |
| check_limits | Token balance, free quota left and when it resets, upload cap, whether PRO modules are available. | free |
| analyze_track | Integrated LUFS, sample peak, duration, sample rate and stereo correlation, without processing. True peak and loudness range come back from get_job after mastering. | free |
| clean_ai_trace | Strips the Suno / Udio AI generator fingerprint; loudness and tone stay as they are. Returns a job id. | free |
| preview_styles | Masters the middle 24 seconds in 2–6 presets at once and returns each one's loudness and a listen link. | free, 6 per day |
| master_track | Masters one track. Costs 1 token when the account has a balance; otherwise it runs on the free quota without PRO modules. Returns a job id. Pass dry_run=true to see the price and effective settings first. | 1 token |
| batch_master | Masters up to 10 tracks in one call with the same settings. album_mode (default true) keeps relative loudness between tracks. Returns one job id per track. | 1 token per track |
| get_job | Status, progress and result metrics (after_lufs, true_peak_db, lra, platform_ready) for a mastering, cleanup or preview job. Includes a signed download_url when a master is done. | free |
| create_topup_link | Prepares a token checkout for the human. The agent cannot complete the payment itself. | free |
Typical flow: analyze_track → (clean_ai_trace for AI-generated tracks) → optionally preview_styles → master_track → poll get_job.
Endpoints and authentication
| Endpoint | Auth | Use it when |
|---|---|---|
| https://magicmaster.pro/mcp | none, or X-API-Key: mm_… | you write the code, you use Claude Code / Cursor / VS Code / Codex with a header, or you only need the free tools |
| https://magicmaster.pro/mcp/oauth | OAuth 2.1 (authorization code + PKCE S256, scope mastering) | your client cannot send custom headers (Claude Desktop, ChatGPT connectors) |
- Without any key, the free tools work on /mcp.
- On /mcp, Authorization: Bearer means an **OAuth access token**. An account JWT sent there returns 401, and it breaks even the free calls. Use X-API-Key on /mcp, or connect through /mcp/oauth.
- /mcp/oauth answers an unauthenticated request with 401 and a WWW-Authenticate challenge pointing at https://magicmaster.pro/.well-known/oauth-protected-resource, so a compliant client starts the sign-in on its own.