MCP
Overview

MCP Server

The Slipstream MCP server lets AI assistants talk to the Slipstream catalog through structured tools. Search tracks in plain language, build playlists, browse genres, preview audio inline, and open tracks back in the Slipstream web app.

It implements the open Model Context Protocol (opens in a new tab). Any MCP-compatible client works: Claude Desktop, Claude Code, claude.ai web, ChatGPT, and others.

Server URL

https://mcp.slipstreammusic.com/mcp

Open to any authenticated Slipstream user. Auth happens through OAuth on the first call, no API keys to manage.

What you can do

The server exposes 17 tools in five areas:

  • Search and discovery. Natural-language search across the catalog, similar-track lookup by URL or ID, browse by genre and mood.
  • Catalog. Fetch full track details, list every genre, list every mood.
  • User and library. Read the signed-in user's profile and liked tracks.
  • Playlists. List, create, read, add tracks, delete, search public playlists.
  • Inline UI. Six of the track-returning tools render a built-in track player with cover art, play/pause, BPM, mood and genre tags, and a Slipstream link.

Public catalog tools work without authentication. Anything that touches a user's library uses the OAuth flow described in Authentication.

When to use MCP vs the REST API

Both surfaces wrap the same backend. Pick by what you're building.

  • MCP is for AI agents that need to reason about music in plain language, no glue code. Add the URL to your client config and the agent can search, curate, and act.
  • REST API is for products you write code for. Direct, versioned, JSON. See the API Reference.

Get connected

The fastest path: open the Quickstart and pick your client. Connecting takes about a minute.

Once connected, jump to Available tools to see what your agent can do.

Authentication

OAuth 2.1 with PKCE. Your MCP client opens a browser tab the first time you use a Slipstream tool. You log in with your Slipstream account (the same one you use on the web), approve, and the client gets a token. From then on, calls run on your behalf, with your existing permissions.

Any Slipstream user tier can connect: Free, Commercial, Subscriber, Enterprise. What you can do through MCP matches what you can do on the web.

Quickstart