get_followed_artists
Retrieve your followed artists list from Spotify to manage your collection, create playlists, check for new releases, and analyze your music preferences.
Instructions
Retrieve the complete list of artists that the user actively follows on Spotify.
🎯 USE CASES: • Managing your followed artists collection • Creating playlists from your favorite artists only • Checking for new releases from followed artists • Organizing your music library by preferred artists • Exporting your music taste profile for other platforms
📝 WHAT IT RETURNS: • Complete list of artists you follow • Artist names, images, and genre information • Follower counts and popularity metrics • Follow date and relationship duration • Quick access to each artist's catalog
🔍 EXAMPLES: • "Show me all artists I follow" • "Get my followed artists, limit to 50" • "Who are the artists in my following list?" • "Export my followed artists for playlist creation"
💡 MANAGEMENT TIPS: • Regularly review to unfollow inactive artists • Use this list to check for new releases • Great for creating "favorites only" playlists • Perfect for music taste analysis and statistics
⚠️ REQUIREMENTS: • Valid Spotify access token with user-follow-read scope • User must have followed at least one artist
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | Yes | Spotify access token for authentication | |
| limit | No |
Implementation Reference
- src/mcp/tools/artists.ts:223-227 (handler)MCP tool handler function for 'get_followed_artists' that destructures input arguments and calls the SpotifyService method.handler: async (args: any, spotifyService: SpotifyService) => { const { token, limit = 20 } = args; return await spotifyService.getFollowedArtists(token, limit); }, },
- src/mcp/tools/artists.ts:219-222 (schema)Input schema definition for the tool using createSchema, validating token and optional limit parameters.schema: createSchema({ token: commonSchemas.token(), limit: commonSchemas.limit(1, 50, 20), }),
- src/spotify.ts:317-330 (helper)SpotifyService helper method implementing the core API call to retrieve user's followed artists via /me/following endpoint.async getFollowedArtists( token: string, limit: number = 20 ): Promise<{ artists: PagingObject<SpotifyArtist> }> { const params = { type: "artist", limit: Math.min(limit, 50), }; return await this.makeRequest<{ artists: PagingObject<SpotifyArtist> }>( "me/following", token, params ); }
- src/mcp/tools/index.ts:22-36 (registration)Registration of artistTools object (containing get_followed_artists) into the central allTools registry used by the ToolRegistrar for MCP server.export const allTools: ToolsRegistry = { ...albumTools, ...artistTools, ...trackTools, ...playlistTools, ...playbackTools, ...userTools, ...searchTools, };