Spotify MCP Server

Implementation Reference

• mcp/spotify-mcp.ts:246-300 (handler)

  Inline handler for get-current-user tool: fetches the current user's Spotify profile (/v1/me) using a valid access token and returns formatted user info (id, name, email, country) or error.

  server.tool("get-current-user", {}, async () => {
    try {
      const accessToken = await getValidAccessToken();
  
      const response = await fetch("https://api.spotify.com/v1/me", {
        headers: {
          Authorization: `Bearer ${accessToken}`,
        },
      });
  
      const data = (await response.json()) as any;
  
      if (!response.ok) {
        return {
          content: [
            {
              type: "text",
              text: `Error getting user profile: ${JSON.stringify(data)}`,
            },
          ],
          isError: true,
        };
      }
  
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(
              {
                id: data.id,
                name: data.display_name,
                email: data.email,
                country: data.country,
              },
              null,
              2
            ),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Failed to get user profile: ${
              error instanceof Error ? error.message : String(error)
            }`,
          },
        ],
        isError: true,
      };
    }
  });

• mcp/spotify-mcp.ts:246-246 (registration)

  Registers the get-current-user tool with empty input schema.

  server.tool("get-current-user", {}, async () => {

• mcp/spotify-mcp-http.js:249-301 (handler)

  HTTP variant inline handler for get-current-user tool, similar to main but JS version with minor differences in error handling.

  server.tool("get-current-user", {}, async () => {
    try {
      const accessToken = await getValidAccessToken();
  
      const response = await fetch("https://api.spotify.com/v1/me", {
        headers: {
          Authorization: `Bearer ${accessToken}`,
        },
      });
  
      const data = await response.json();
  
      if (!response.ok) {
        return {
          content: [
            {
              type: "text",
              text: `Error getting user profile: ${JSON.stringify(data)}`,
            },
          ],
          isError: true,
        };
      }
  
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(
              {
                id: data.id,
                name: data.display_name,
                email: data.email,
                country: data.country,
              },
              null,
              2
            ),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Failed to get user profile: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  });

• mcp/spotify-mcp-oauth-http.js:329-371 (handler)

  OAuth HTTP variant handler using handleSpotifyTool helper, includes followers count, throws errors instead of returning isError.

  server.registerTool(
    "get-current-user",
    {
      title: "Get Current User",
      description: "Get current Spotify user information",
    },
    async () => {
      return await handleSpotifyTool(sessionId, async (accessToken) => {
        const response = await fetch("https://api.spotify.com/v1/me", {
          headers: {
            Authorization: `Bearer ${accessToken}`,
          },
        });
  
        const data = await response.json();
  
        if (!response.ok) {
          throw new Error(
            `Spotify API error: ${data.error?.message || "Unknown error"}`
          );
        }
  
        return {
          content: [
            {
              type: "text",
              text: JSON.stringify(
                {
                  id: data.id,
                  name: data.display_name,
                  email: data.email,
                  country: data.country,
                  followers: data.followers?.total || 0,
                },
                null,
                2
              ),
            },
          ],
        };
      });
    }
  );