# SoundCloud Alternative MCP

> SoundCloud Alternative MCP Server lets your AI agent search, manage, and interact with millions of audio tracks directly from SoundCloud. You can find specific music using keywords, get stream URLs for integration into other apps, upload new content, or build entire playlists without leaving the chat interface.

## Overview
- **Category:** audio-music
- **Price:** Free
- **Tags:** music-streaming, audio-upload, playlist-management, soundcloud-api, audio-discovery

## Description

You connect your SoundCloud account to your AI client, giving it deep control over your audio library. This server lets your agent search, manage, and interact with millions of tracks directly from SoundCloud. You can find specific music using keywords, get stream URLs for integration into other apps, upload new content, or build entire playlists without ever leaving the chat interface.

**Searching and Finding Audio Content**

The `search_tracks` tool lets your agent query the whole SoundCloud catalog. You just give it keywords or filters, and it returns detailed metadata on every matching track. It’s quick work for finding that niche lo-fi beat you can’t remember the name of. If you've got a messy permalink—one of those long URLs with random letters—don't sweat it; the `resolve_url` tool takes that garbage link and converts it into clean, usable API resource data. It makes sure your AI client knows exactly what track you’re talking about.

**Retrieving Stream Links and Uploading Assets**

Need audio for a script or an external project? You use `get_track_stream` to pull the necessary stream URLs and transcoding details. This gives your agent everything it needs to integrate that audio into another app, bypassing simple embeds. For contributing new stuff, you can use the `upload_track` tool. Just push raw file content or placeholder data directly to SoundCloud; the server handles uploading it as a brand-new track on your account.

**Building and Organizing Playlists**

You've found the tracks, now you gotta organize 'em. The `create_playlist` tool lets you build an entirely new collection right off the bat. If that playlist already exists, you can use `like_playlist` to add your like count to it. You also mark tracks you dig with the `like_track` tool, adding those individual likes to a specific piece of audio.

**Managing Connections and Profile Details**

Your agent uses `get_me` to fetch all your current SoundCloud profile details, so it always knows who you are in the system. When you find an artist whose work you dig, the `follow_user` tool lets your AI client change your profile status to follow that user's content. It’s how you keep tabs on who’s dropping new heat.

This setup means you don't have to copy-paste links or hop between apps. Your agent manages discovery, streaming access, organization, and social actions all in one place.

## Tools

### resolve_url
Takes any messy SoundCloud permalink and converts it into clean, usable API resource data.

### search_tracks
Searches the entire SoundCloud catalog for tracks matching provided keywords or filters.

### upload_track
Uploads a new audio track file to your account on SoundCloud.

### create_playlist
Creates a brand new playlist on your SoundCloud account.

### follow_user
Changes your profile to follow another user's content on SoundCloud.

### get_track_stream
Fetches the necessary stream URLs for a specific audio track ID so you can use it elsewhere.

### like_playlist
Adds your like to an existing playlist on SoundCloud.

### like_track
Marks a specific track as 'liked' from your account.

### get_me
Retrieves and shows you the current details of your SoundCloud account.

## Prompt Examples

**Prompt:** 
```
Search for lo-fi hip hop tracks on SoundCloud with a limit of 5 results.
```

**Response:** 
```
I found 5 lo-fi hip hop tracks for you. Highlights include 'Midnight Study' by LofiGirl and 'Rainy Nights'. Would you like the stream URLs for any of these?
```

**Prompt:** 
```
Identify the track at this URL: https://soundcloud.com/forss/flickermood
```

**Response:** 
```
Resolving URL... That link corresponds to the track 'Flickermood' by Forss (ID: 12345). It has over 1 million plays and is tagged as 'Electronic'.
```

**Prompt:** 
```
Like the track with ID 12345 for me.
```

**Response:** 
```
Done! I've added track 12345 ('Flickermood') to your liked tracks on SoundCloud.
```

## Capabilities

### Search and find audio content
The `search_tracks` tool lets your agent query SoundCloud using keywords or filters, returning metadata on matching tracks.

### Retrieve stream links for any track
Use `get_track_stream` to pull the necessary stream URLs and transcoding data needed to integrate audio into a project.

### Build and organize playlists
You can create new collections with `create_playlist`, or enhance existing ones using `like_playlist`.

### Manage user identity and connections
The agent uses `get_me` to fetch your current SoundCloud profile details, and `follow_user` to connect with artists.

### Upload new audio assets
Use the `upload_track` tool to push raw file content or placeholder data directly to SoundCloud as a new track.

## Use Cases

### Curating an EP playlist from scratch
A user needs to build a themed playlist for a mixtape. They ask their agent: 'Find 10 tracks about late-night drives.' The agent runs `search_tracks`. The user reviews the results and tells the agent to `like_track` on five specific IDs, then finally calls `create_playlist` with all those selected tracks.

### Debugging a bad link
A developer gets an old SoundCloud permalink. Instead of testing it in multiple browser modes, they give the link to their agent and call `resolve_url`. The agent instantly validates the link and returns the full API resource data for them to inspect.

### Integrating audio into a project
A developer needs background music. They use `search_tracks` to find suitable beats, then pass the result ID to `get_track_stream`. The agent returns the raw stream URLs needed for their app's backend code.

### Adding new material to the portfolio
A content creator finishes a track. They use the `upload_track` tool, providing the file data, and then immediately follow up by calling `search_tracks` for similar beats to suggest additions to their project.

## Benefits

- Find assets fast. Instead of manually sifting through results, `search_tracks` lets your agent filter the entire catalog by keywords or access levels immediately.
- Get data for code. Need a stream URL? Use `get_track_stream`. It pulls out the necessary URLs and transcoding details so you can plug audio directly into scripts.
- Build collections hands-free. You don't need to visit a playlist page to organize; just tell your agent to `create_playlist` or use `like_playlist` right in the chat.
- Keep track of everything. With `resolve_url`, you never have to worry about link formatting again. Just paste the URL, and it gives you structured data for inspection.
- Stay connected. Use `follow_user` or `like_track` directly through your AI client. Your engagement history updates without opening a browser tab.

## How It Works

The bottom line is: you authorize one connection point for all your SoundCloud activity through a single conversation with your AI client.

1. First, subscribe to the server and give your AI client your SoundCloud Access Token.
2. Next, ask your agent to perform an action. For example: 'Find five tracks about rainy days.' (Uses `search_tracks`).
3. Finally, the tool returns structured data (like track IDs or stream URLs) that your agent uses to complete tasks like calling `get_track_stream` or passing results to `create_playlist`.

## Frequently Asked Questions

**How do I find tracks using SoundCloud Alternative MCP Server?**
Use the `search_tracks` tool. Just tell your agent what keywords or filters you want to use, and it handles the search against the entire catalog.

**Can I get a stream URL for a track using SoundCloud Alternative MCP Server?**
Yes, call `get_track_stream` and provide the specific track ID. This returns the necessary URLs and transcoding details ready for your code.

**Does SoundCloud Alternative MCP Server let me upload my own music?**
Yep. Use the `upload_track` tool. You give it the raw file content, and the server handles getting that asset live on SoundCloud.

**What if a link I paste is old or broken using SoundCloud Alternative MCP Server?**
Run `resolve_url`. This function validates the permalink structure and converts it into full API resource data, letting you know immediately if the link is bad.

**How do I set up authentication for SoundCloud Alternative MCP Server?**
You connect by providing a valid SoundCloud Access Token. When you subscribe to the server, your AI client uses this token to authorize all subsequent actions, letting it manage tracks and profiles on your behalf.

**How do I use the `create_playlist` tool with SoundCloud Alternative MCP Server?**
You call the `create_playlist` function, specifying a name and optionally adding initial track IDs. The server then handles the playlist creation within your account's library.

**How do I use the `follow_user` tool with SoundCloud Alternative MCP Server?**
Simply provide the username of the artist or user you want to follow. This action executes instantly, adding them to your followed list on SoundCloud without needing manual navigation.

**How do I check my current profile details using SoundCloud Alternative MCP Server?**
Use the `get_me` tool; it pulls all relevant metadata about your connected account. This lets you confirm things like your display name, profile picture URL, and follower count.

**How can I get the details of a track if I only have the browser URL?**
You can use the `resolve_url` tool. Simply provide the SoundCloud permalink (e.g., https://soundcloud.com/artist/track), and the agent will return the full API resource including ID, title, and metadata.

**Can I upload audio files directly through this server?**
Yes! The `upload_track` tool allows you to send a title and the asset data to SoundCloud. This is perfect for automating uploads or managing your creator profile.

**Is it possible to get the actual stream link for a track?**
Absolutely. Use the `get_track_stream` tool with a valid Track ID to retrieve available transcodings and direct stream URLs.