SoundCloud MCP Server v2
by kosoymiki
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Listen address. | 127.0.0.1 |
| PORT | No | Listen port. | 3000 |
| DATA_DIR | No | Directory for encrypted state, keys, and temporary uploads; should be mode 0700. | ~/.local/share/soundcloud-mcp |
| MCP_MODE | No | MCP authorization mode: local, oauth, or both. | both |
| LOG_LEVEL | No | Logging level. | info |
| MCP_DEBUG | No | Enable diagnostic debugging output. | false |
| PUBLIC_URL | No | Public origin; https:// enables HSTS and Secure cookies. | http://localhost:PORT |
| FFMPEG_PATH | No | Path to the ffmpeg binary. | ffmpeg |
| SC_API_BASE | No | SoundCloud API base URL override for testing or proxying. | production |
| FFPROBE_PATH | No | Path to the ffprobe binary. | ffprobe |
| SC_AUTH_BASE | No | SoundCloud auth base URL override for testing or proxying. | production |
| SC_CLIENT_ID | No | SoundCloud app client ID, per device. | |
| SC_MEDIA_DIRS | No | Colon-separated allowlist of upload and audio file paths. | ~ |
| SC_WEB_CHROME | No | Chrome or Chromium binary used for web-session tools. | chromium-browser |
| AUDIO_WORK_DIR | No | Allowed output directory for audio processing. | DATA_DIR/edits |
| SC_AUTH_SCHEME | No | SoundCloud authorization scheme: OAuth for current apps or Bearer for legacy apps. | OAuth |
| UI_BRAND_COLOR | No | Panel accent color. | #f50 |
| MCP_LOCAL_TOKEN | No | Bearer token for non-OAuth MCP clients; generated if not provided and stored with mode 0600. | generated |
| MCP_TRUST_PROXY | No | Trust X-Forwarded-* headers, only behind a trusted reverse proxy. | false |
| SC_ACCESS_TOKEN | No | Optional SoundCloud access token for headless bootstrap. | |
| SC_REDIRECT_URI | No | OAuth redirect URI; must be registered in the SoundCloud app. | ${PUBLIC_URL}/soundcloud/callback |
| SC_WEB_HEADLESS | No | Run the web-session browser headless. | true |
| MCP_OPEN_BROWSER | No | Allow open_auth_window and npm run auth to open a browser. | true |
| SC_CLIENT_SECRET | No | SoundCloud app client secret, per device. | |
| SC_REFRESH_TOKEN | No | Optional SoundCloud refresh token for headless bootstrap. | |
| SC_WEB_CLIENT_ID | No | api-v2 client ID used for verification; defaults to the JWT claim. | JWT claim |
| SC_WEB_TOKEN_URL | No | Token endpoint used by cookies --refresh. | https://secure.soundcloud.com/oauth/token |
| CHROME_COOKIES_DB | No | Chrome or Chromium cookie database used by web-upload cookies. | auto-detected |
| SC_WEB_DEBUG_PORT | No | Chrome DevTools Protocol port; reuses an existing browser when set. | 9333 |
| SC_WEB_TIMEOUT_MS | No | Web-session navigation timeout in milliseconds. | 90000 |
| SC_WEB_UPLOAD_URL | No | Page used for SoundCloud upload action discovery. | https://soundcloud.com/n/upload |
| MCP_ENCRYPTION_KEY | No | 32-byte base64 AES-256-GCM encryption key; generated if not provided and stored with mode 0600. | generated |
| SC_WEB_COOKIE_FILE | No | Path to exported SoundCloud cookies; should be mode 0600. | DATA_DIR/chrome-soundcloud-cookies.json |
| SC_MAX_UPLOAD_BYTES | No | Hard upload size cap. | 4 GiB |
| AUDIO_MAX_CONCURRENT | No | Maximum number of concurrent ffmpeg jobs. | 2 |
| MCP_ACCESS_TOKEN_TTL | No | Server access token time-to-live. | 7 d |
| MCP_PANEL_AUTO_LOGIN | No | Reuse a local connection for loopback panel requests. | true |
| MCP_SESSION_IDLE_TTL | No | Idle MCP session time-to-live. | 30 min |
| MCP_REFRESH_TOKEN_TTL | No | Server refresh token time-to-live. | 30 d |
| SC_ALLOW_COOKIES_IN_REPO | No | Allow cookie exports inside a git work tree; unsafe default. | 0 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues