tonn-mcp

# Tonn MCP Server MCP (Model Context Protocol) server for the [RoEx Tonn API](https://tonn.roexaudio.com) — AI-powered audio mixing, mastering, and analysis. This server exposes Tonn's audio processing capabilities as MCP tools, enabling AI assistants like Claude to mix, master, and analyse audio directly in conversation. ## Tools | Tool | Description | Credits | |------|-------------|---------| | `get_account_status` | View plan, credit balance, and recent tasks | Free | | `get_upload_url` | Get a signed URL for uploading audio files | Free | | `analyse_mix` | Analyse a mix or master for loudness, frequency balance, stereo width, and more | Charged | | `master_track` | Master a track with configurable loudness and style (preview or final) | Preview free, final charged | | `get_job_status` | Check the status of a long-running processing job | Free | ## Authentication This server uses OAuth 2.0 with the Tonn Portal as the Authorization Server. Users authenticate through their existing Tonn account — no API key pasting required. The server implements RFC 9728 (Protected Resource Metadata) for automatic AS discovery. ## Deployment ### Cloud Run ```bash gcloud run deploy tonn-mcp \ --source . \ --region europe-west1 \ --allow-unauthenticated \ --set-env-vars "TONN_MCP_PORTAL_URL=https://tonn-portal.roexaudio.com,TONN_MCP_API_URL=https://tonn.roexaudio.com,TONN_MCP_SERVER_URL=https://mcp.roexaudio.com" ``` ### Local development ```bash pip install -e . TONN_MCP_PORTAL_URL=http://localhost:5000 TONN_MCP_API_URL=https://tonn.roexaudio.com TONN_MCP_SERVER_URL=http://localhost:8080 uvicorn tonn_mcp.server:app --port 8080 --reload ``` ## License MIT