SoundCloud MCP server for AI agents
Let Claude, ChatGPT or your own agent read SoundCloud: 3 typed functions through one MCP server. No SoundCloud API key needed.
- Site
- soundcloud.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just SoundCloud
An MCP server for SoundCloud alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/soundcloudEvery site
One MCP server for SoundCloud and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 3
getPlaylistReads a SoundCloud set or playlist URL and returns its tracks in order.Arguments
Name Type Required playliststring | ScPlaylistYes limitnumberNo // SoundCloud's OWN row shape, not the `music` capability contract. interface ScTrack { id: number // SoundCloud's numeric track id title: string // the track title as uploaded artist: string // the uploading account's display name url: string // public track page on soundcloud.com durationMs: number // track length in milliseconds playCount: number | null // plays; null when the track doesn't expose a count } // A set, playlist, album, EP or compilation. SoundCloud stores all four as one // kind and tells them apart with isAlbum/setType. interface ScPlaylist { id: number title: string url: string // public set page on soundcloud.com curator: string // the account that published the set description: string | null artworkUrl: string | null genre: string | null isAlbum: boolean // true for a release, false for an assembled playlist setType: string | null // "album" | "ep" | "compilation" | null trackCount: number // the SET's own count, compare against tracks.length durationMs: number // the WHOLE set's runtime, not the sum of tracks likeCount: number | null createdAt: string | null tracks: ScTrack[] // IN THE CURATOR'S ORDER }Returns
ScPlaylist// SoundCloud's OWN row shape, not the `music` capability contract. interface ScTrack { id: number // SoundCloud's numeric track id title: string // the track title as uploaded artist: string // the uploading account's display name url: string // public track page on soundcloud.com durationMs: number // track length in milliseconds playCount: number | null // plays; null when the track doesn't expose a count } // A set, playlist, album, EP or compilation. SoundCloud stores all four as one // kind and tells them apart with isAlbum/setType. interface ScPlaylist { id: number title: string url: string // public set page on soundcloud.com curator: string // the account that published the set description: string | null artworkUrl: string | null genre: string | null isAlbum: boolean // true for a release, false for an assembled playlist setType: string | null // "album" | "ep" | "compilation" | null trackCount: number // the SET's own count, compare against tracks.length durationMs: number // the WHOLE set's runtime, not the sum of tracks likeCount: number | null createdAt: string | null tracks: ScTrack[] // IN THE CURATOR'S ORDER }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soundcloud/getPlaylistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soundcloud.getPlaylist("<playlist>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soundcloud.getPlaylist("<playlist>"))curl -X POST https://api.bowmark.ai/v1/sites/soundcloud/getPlaylist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"playlist":"<playlist>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soundcloud.getPlaylist("<playlist>");getTrackResolves one soundcloud.com track URL to its full metadata.Arguments
Name Type Required trackstring | ScTrackYes // SoundCloud's OWN row shape, not the `music` capability contract. interface ScTrack { id: number // SoundCloud's numeric track id title: string // the track title as uploaded artist: string // the uploading account's display name url: string // public track page on soundcloud.com durationMs: number // track length in milliseconds playCount: number | null // plays; null when the track doesn't expose a count }Returns
ScTrackDetail// SoundCloud's OWN row shape, not the `music` capability contract. interface ScTrack { id: number // SoundCloud's numeric track id title: string // the track title as uploaded artist: string // the uploading account's display name url: string // public track page on soundcloud.com durationMs: number // track length in milliseconds playCount: number | null // plays; null when the track doesn't expose a count } // What getTrack adds on top: the fields a search row never carried. interface ScTrackDetail extends ScTrack { artworkUrl: string | null // cover image; null when uploaded without one description: string | null // uploader's notes, a mix's tracklist lives here genre: string | null likeCount: number | null // null when not reported (never 0) releaseDate: string | null // the publisher's release date, not the upload date publisherArtist: string | null // label credit ("Aphex Twin") vs the account ("aphextwin") labelName: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soundcloud/getTrackCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soundcloud.getTrack("<track>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soundcloud.getTrack("<track>"))curl -X POST https://api.bowmark.ai/v1/sites/soundcloud/getTrack \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"track":"<track>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soundcloud.getTrack("<track>");searchSearches SoundCloud's catalogue for tracks matching a free-text query and returns up to limit rows in SoundCloud's own relevance order.Arguments
Name Type Required querystringYes limitnumberNo Returns
ScTrack[]// SoundCloud's OWN row shape, not the `music` capability contract. interface ScTrack { id: number // SoundCloud's numeric track id title: string // the track title as uploaded artist: string // the uploading account's display name url: string // public track page on soundcloud.com durationMs: number // track length in milliseconds playCount: number | null // plays; null when the track doesn't expose a count }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/soundcloud/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.soundcloud.search("aphex twin", 5);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.soundcloud.search("aphex twin", 5))curl -X POST https://api.bowmark.ai/v1/sites/soundcloud/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"aphex twin","limit":5}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.soundcloud.search("aphex twin", 5);
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/soundcloud/<function> - OpenAPI
/v1/sites/soundcloud/openapi.json