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.

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/soundcloud
Every 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/mcp
Set it up in your client

Both 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

    NameTypeRequired
    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/getPlaylist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soundcloud.getPlaylist("<playlist>");
  • getTrackResolves one soundcloud.com track URL to its full metadata.

    Arguments

    NameTypeRequired
    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/getTrack

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.soundcloud.getTrack("<track>");

Use it from code