get_artist_top_tracks

Retrieve an artist's most popular tracks globally or by country using Spotify streaming data to identify hits and build playlists.

Instructions

Discover an artist's most popular and widely-played tracks based on global streaming data.

🎯 USE CASES: • Quick introduction to an artist's biggest hits • Building "best of" playlists for parties or events • Understanding which songs made an artist famous • Creating radio-friendly playlists with mainstream appeal • Checking what's trending from your favorite artists

📝 WHAT IT RETURNS: • Top 10 tracks ranked by global popularity • Track names, album information, and release dates • Popularity scores and play count estimates • Preview URLs and track durations • Market-specific popularity rankings

🔍 EXAMPLES: • "What are Ed Sheeran's top tracks?" • "Show me The Weeknd's biggest hits in the US" • "Get Ariana Grande's most popular songs" • "Find the top tracks for artist ID: 1Xyo4u8uXC1ZmMpatF05PJ"

🌍 MARKET SPECIFICITY: • Results can vary by country/region • Reflects local music preferences and cultural differences • Use country parameter for region-specific results • Defaults to US market if not specified

⚠️ REQUIREMENTS: • Valid Spotify access token • Artist must have released tracks

Input Schema

TableJSON Schema

Name	Required	Description
`token`	Yes	Spotify access token for authentication
`artistId`	Yes	Spotify artist ID or URI
`country`	No	Country code for localized content (e.g., 'US', 'GB')

Implementation Reference

src/mcp/tools/artists.ts:135-138 (handler)
The handler function for the MCP 'get_artist_top_tracks' tool. It destructures the input arguments and delegates the API call to SpotifyService.getArtistTopTracks.
```
handler: async (args: any, spotifyService: SpotifyService) => {
  const { token, artistId, country = "US" } = args;
  return await spotifyService.getArtistTopTracks(token, artistId, country);
},
```
src/mcp/tools/artists.ts:130-134 (schema)
The input schema for the 'get_artist_top_tracks' tool defining validation for token, artistId, and optional country parameters.
```
schema: createSchema({
  token: commonSchemas.token(),
  artistId: commonSchemas.spotifyId("artist"),
  country: commonSchemas.country(),
}),
```
src/mcp/tools/index.ts:22-36 (registration)
Registration of all tools including artistTools (which contains get_artist_top_tracks) into the central allTools registry used by ToolRegistrar for MCP tool exposure.
```
export const allTools: ToolsRegistry = {
  ...albumTools,

  ...artistTools,

  ...trackTools,

  ...playlistTools,

  ...playbackTools,

  ...userTools,

  ...searchTools,
};
```

src/spotify.ts:401-413 (helper)

The SpotifyService helper method that performs the actual Spotify API request to retrieve the top tracks for an artist in a specific market.

async getArtistTopTracks(
  token: string,
  artistId: string,
  country: string = "US"
): Promise<{ tracks: SpotifyTrack[] }> {
  const id = this.extractId(artistId);
  const params = { market: country };
  return await this.makeRequest<{ tracks: SpotifyTrack[] }>(
    `artists/${id}/top-tracks`,
    token,
    params
  );
}

Spotify MCP Server