MCP Spotify Server

Instructions

Implementation Reference

• src/utils/auth.ts:15-50 (handler)

  Core handler function that implements the logic to retrieve or refresh the Spotify access token using client credentials grant type, with caching based on expiration.

  async getAccessToken(): Promise<string> {
    // Check if we have a valid token
    if (this.tokenInfo && Date.now() < this.tokenInfo.expiresAt) {
      return this.tokenInfo.accessToken;
    }
  
    // Get new token
    try {
      const response = await axios.post('https://accounts.spotify.com/api/token', 
        new URLSearchParams({
          grant_type: 'client_credentials'
        }).toString(),
        {
          headers: {
            'Content-Type': 'application/x-www-form-urlencoded',
            'Authorization': 'Basic ' + Buffer.from(SPOTIFY_CLIENT_ID + ':' + SPOTIFY_CLIENT_SECRET).toString('base64')
          }
        }
      );
  
      this.tokenInfo = {
        accessToken: response.data.access_token,
        expiresAt: Date.now() + (response.data.expires_in * 1000)
      };
  
      return this.tokenInfo.accessToken;
    } catch (error) {
      if (axios.isAxiosError(error)) {
        throw new McpError(
          ErrorCode.InternalError,
          `Failed to get Spotify access token: ${error.response?.data?.error ?? error.message}`
        );
      }
      throw error;
    }
  }

• src/index.ts:695-700 (handler)

  MCP tool dispatch handler case for 'get_access_token' that invokes AuthManager.getAccessToken() and returns the token as text content.

  case 'get_access_token': {
    const token = await this.authManager.getAccessToken();
    return {
      content: [{ type: 'text', text: token }],
    };
  }

• src/index.ts:106-113 (registration)

  Registration of the 'get_access_token' tool in the MCP server's list of available tools, including name, description, and schema.

  {
    name: 'get_access_token',
    description: 'Get a valid Spotify access token for API requests',
    inputSchema: {
      type: 'object',
      properties: {},
      required: []
    },

• src/index.ts:109-112 (schema)

  Input schema definition for the 'get_access_token' tool, which requires no parameters (empty object).

  inputSchema: {
    type: 'object',
    properties: {},
    required: []

• src/utils/api.ts:21-21 (helper)

  Usage of getAccessToken in SpotifyApi.makeRequest as a supporting utility.

  const token = await this.authManager.getAccessToken();