Spotify MCP Server

Instructions

Implementation Reference

• src/spotify.ts:415-426 (handler)

  Core handler function that executes the Spotify API search for artists using the /search endpoint with type='artist'.
  async searchArtists( token: string, query: string, limit: number = 20 ): Promise<SearchResult> { const params = { q: query, type: "artist", limit: Math.min(limit, 50), }; return await this.makeRequest<SearchResult>("search", token, params); }
• src/mcp/tools/artists.ts:141-184 (registration)

  MCP tool definition and registration for 'search_artists', including title, description, input schema using commonSchemas, and handler wrapper that calls SpotifyService.searchArtists.
  search_artists: { title: "Search Artists", description: `Search for artists using names, genres, or keywords to discover new music and talent. 🎯 USE CASES: • Finding artists when you only remember partial names • Discovering artists within specific genres or styles • Locating emerging or independent artists • Building diverse playlists with multiple artists • Researching artists for events or collaborations 📝 WHAT IT RETURNS: • Ranked artist results based on search relevance • Artist names, images, and genre classifications • Popularity scores and follower counts • Links to explore each artist's catalog • External URLs and social media links 🔍 EXAMPLES: • "Search for 'jazz pianist' artists" • "Find artists named 'John'" • "Look for 'indie rock' bands" • "Search for artists from 'Nashville'" • "Find 'female rapper' artists" 💡 SEARCH STRATEGIES: • Use genre keywords: "progressive metal", "folk acoustic" • Include location: "Seattle grunge", "Detroit techno" • Try instrument-specific searches: "saxophone", "violin" • Use descriptive terms: "soulful", "experimental", "classical" ⚠️ REQUIREMENTS: • Valid Spotify access token • Meaningful search keywords for best results`, schema: createSchema({ token: commonSchemas.token(), query: commonSchemas.searchQuery("artists (artist name, keywords)"), limit: commonSchemas.limit(1, 50, 20), }), handler: async (args: any, spotifyService: SpotifyService) => { const { token, query, limit = 20 } = args; return await spotifyService.searchArtists(token, query, limit); }, },
• src/mcp/tools/index.ts:25-25 (registration)

  Aggregates artistTools (containing search_artists) into allTools registry used by ToolRegistrar for MCP tool exposure.
  ...artistTools,
• src/mcp/tools/artists.ts:175-179 (schema)

  Input schema definition for search_artists tool using createSchema from common schemas.
  schema: createSchema({ token: commonSchemas.token(), query: commonSchemas.searchQuery("artists (artist name, keywords)"), limit: commonSchemas.limit(1, 50, 20), }),