Connect your AI Agents to Spotify in minutes
Available tools
get_album
Get details for a Spotify album by ID. Returns album name, artists, tracks, release date, genres, and more.
list_album_tracks
List tracks in a Spotify album with pagination. Use offset from page_info to fetch next page.
get_artist
Get details for a Spotify artist by ID. Returns name, genres, popularity, followers, and images.
list_artist_albums
List albums by a Spotify artist with pagination. Filter by include_groups (album, single, appears_on, compilation).
get_audiobook
Get details for a Spotify audiobook by ID. Returns name, authors, narrators, publisher, chapters, and more.
list_audiobook_chapters
List chapters of a Spotify audiobook with pagination. Use offset from page_info for next page.
get_chapter
Get details for a Spotify audiobook chapter by ID. Returns name, description, duration, chapter number, and more.
get_episode
Get details for a Spotify episode by ID. Returns name, description, duration, release date, show info, and more.
follow
Follow artists or users on Spotify. Provide type ('artist' or 'user') and list of Spotify IDs.
unfollow
Unfollow artists or users on Spotify. Provide type ('artist' or 'user') and list of Spotify IDs.
list_followed_artists
List artists the user follows. Cursor-based pagination: use 'after' from page_info.cursor for next page.
list_saved_tracks
List the current user's saved tracks with pagination. Use offset from page_info for next page.
How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Spotify MCP server
FAQs on using Merge's Spotify MCP server
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
