Spotify MCP Server

Instructions

Implementation Reference

• src/index.ts:540-558 (handler)

  Handler for get_top_artists tool: extracts limit and time_range parameters, makes Spotify API request to /me/top/artists endpoint, formats response with artist name, genres, and followers count

  case "get_top_artists": {
    const limit = (args.limit as number) || 10;
    const timeRange = (args.time_range as string) || "medium_term";
  
    const data = await spotifyRequest(
      `/me/top/artists?limit=${limit}&time_range=${timeRange}`
    );
  
    let resultText = `👤 Your Top ${limit} Artists:\n\n`;
    data.items.forEach((artist: any, index: number) => {
      resultText += `${index + 1}. ${artist.name}\n`;
      resultText += `   🎭 Genres: ${artist.genres.slice(0, 3).join(", ")}\n`;
      resultText += `   👥 Followers: ${artist.followers.total.toLocaleString()}\n\n`;
    });
  
    return {
      content: [{ type: "text", text: resultText }],
    };
  }

• src/index.ts:261-279 (schema)

  Tool registration with input schema defining two optional parameters: limit (number, default 10) and time_range (enum: short_term/medium_term/long_term, default medium_term)

    name: "get_top_artists",
    description: "Get your top artists",
    inputSchema: {
      type: "object",
      properties: {
        limit: {
          type: "number",
          description: "Number of artists to return (1-50, default: 10)",
          default: 10,
        },
        time_range: {
          type: "string",
          enum: ["short_term", "medium_term", "long_term"],
          description: "Time range (short_term: 4 weeks, medium_term: 6 months, long_term: all time)",
          default: "medium_term",
        },
      },
    },
  },

• src/index.ts:54-74 (helper)

  spotifyRequest helper function that handles authentication and makes HTTP requests to the Spotify API, used by get_top_artists handler

  async function spotifyRequest(endpoint: string, method = "GET", data?: any) {
    const token = await getAccessToken();
    
    try {
      const response = await axios({
        method,
        url: `https://api.spotify.com/v1${endpoint}`,
        headers: {
          Authorization: `Bearer ${token}`,
          "Content-Type": "application/json",
        },
        data,
      });
      return response.data;
    } catch (error: any) {
      if (error.response) {
        throw new Error(`Spotify API Error: ${error.response.data.error?.message || error.response.statusText}`);
      }
      throw new Error(`Network Error: ${error.message}`);
    }
  }