spotted-ts-mcp 0.1.0

package/src/tools/me/top/list-top-artists-me-top.ts

@@ -0,0 +1,62 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'spotted-ts-mcp/filtering';
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'me.top',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/top/artists',
+  operationId: 'get-users-top-artists',
+};
+
+export const tool: Tool = {
+  name: 'list_top_artists_me_top',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet the current user's top artists based on calculated affinity.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    href: {\n      type: 'string',\n      description: 'A link to the Web API endpoint returning the full result of the request\\n'\n    },\n    items: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/artist_object'\n      }\n    },\n    limit: {\n      type: 'integer',\n      description: 'The maximum number of items in the response (as set in the query or by default).\\n'\n    },\n    next: {\n      type: 'string',\n      description: 'URL to the next page of items. ( `null` if none)\\n'\n    },\n    offset: {\n      type: 'integer',\n      description: 'The offset of the items returned (as set in the query or by default)\\n'\n    },\n    previous: {\n      type: 'string',\n      description: 'URL to the previous page of items. ( `null` if none)\\n'\n    },\n    total: {\n      type: 'integer',\n      description: 'The total number of items available to return.\\n'\n    }\n  },\n  required: [    'href',\n    'items',\n    'limit',\n    'next',\n    'offset',\n    'previous',\n    'total'\n  ],\n  $defs: {\n    artist_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        followers: {\n          $ref: '#/$defs/followers_object'\n        },\n        genres: {\n          type: 'array',\n          description: 'A list of the genres the artist is associated with. If not yet classified, the array is empty.\\n',\n          items: {\n            type: 'string'\n          }\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the artist.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'Images of the artist in various sizes, widest first.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the artist.\\n'\n        },\n        popularity: {\n          type: 'integer',\n          description: 'The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist\\'s popularity is calculated from the popularity of all the artist\\'s tracks.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'artist'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    followers_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'This will always be set to null, as the Web API does not support it at the moment.\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'The total number of followers.\\n'\n        }\n      }\n    },\n    image_object: {\n      type: 'object',\n      properties: {\n        height: {\n          type: 'integer',\n          description: 'The image height in pixels.\\n'\n        },\n        url: {\n          type: 'string',\n          description: 'The source URL of the image.\\n'\n        },\n        width: {\n          type: 'integer',\n          description: 'The image width in pixels.\\n'\n        }\n      },\n      required: [        'height',\n        'url',\n        'width'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      limit: {
+        type: 'integer',
+        title: 'Limit',
+        description: 'The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n',
+      },
+      offset: {
+        type: 'integer',
+        title: 'Offset',
+        description:
+          'The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.\n',
+      },
+      time_range: {
+        type: 'string',
+        title: 'Time Range',
+        description:
+          'Over what time frame the affinities are computed. Valid values: `long_term` (calculated from ~1 year of data and including all new data as it becomes available), `medium_term` (approximately last 6 months), `short_term` (approximately last 4 weeks). Default: `medium_term`\n',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: [],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const { jq_filter, ...body } = args as any;
+  const response = await client.me.top.listTopArtists(body).asResponse();
+  return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/top/list-top-tracks-me-top.ts

@@ -0,0 +1,54 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'me.top',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/top/tracks',
+  operationId: 'get-users-top-tracks',
+};
+
+export const tool: Tool = {
+  name: 'list_top_tracks_me_top',
+  description: "Get the current user's top tracks based on calculated affinity.\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      limit: {
+        type: 'integer',
+        title: 'Limit',
+        description: 'The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n',
+      },
+      offset: {
+        type: 'integer',
+        title: 'Offset',
+        description:
+          'The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.\n',
+      },
+      time_range: {
+        type: 'string',
+        title: 'Time Range',
+        description:
+          'Over what time frame the affinities are computed. Valid values: `long_term` (calculated from ~1 year of data and including all new data as it becomes available), `medium_term` (approximately last 6 months), `short_term` (approximately last 4 weeks). Default: `medium_term`\n',
+      },
+    },
+    required: [],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const response = await client.me.top.listTopTracks(body).asResponse();
+  return asTextContentResult(await response.json());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/tracks/check-me-tracks.ts

@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'spotted-ts-mcp/filtering';
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'me.tracks',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/tracks/contains',
+  operationId: 'check-users-saved-tracks',
+};
+
+export const tool: Tool = {
+  name: 'check_me_tracks',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCheck if one or more tracks is already saved in the current Spotify user's 'Your Music' library.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/track_check_response',\n  $defs: {\n    track_check_response: {\n      type: 'array',\n      items: {\n        type: 'boolean'\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'string',
+        title: 'Spotify Track IDs',
+        description:
+          'A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example: `ids=4iV5W9uYEdYUVa79Axb7Rh,1301WleyT98MSxVHPZCA6M`. Maximum: 50 IDs.\n',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['ids'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.me.tracks.check(body)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/tracks/list-me-tracks.ts

@@ -0,0 +1,54 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'me.tracks',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/tracks',
+  operationId: 'get-users-saved-tracks',
+};
+
+export const tool: Tool = {
+  name: 'list_me_tracks',
+  description: "Get a list of the songs saved in the current Spotify user's 'Your Music' library.\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      limit: {
+        type: 'integer',
+        title: 'Limit',
+        description: 'The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n',
+      },
+      market: {
+        type: 'string',
+        title: 'Market',
+        description:
+          'An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).\n  If a country code is specified, only content that is available in that market will be returned.<br/>\n  If a valid user access token is specified in the request header, the country associated with\n  the user account will take priority over this parameter.<br/>\n  _**Note**: If neither market or user country are provided, the content is considered unavailable for the client._<br/>\n  Users can view the country that is associated with their account in the [account settings](https://www.spotify.com/account/overview/).\n',
+      },
+      offset: {
+        type: 'integer',
+        title: 'Offset',
+        description:
+          'The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.\n',
+      },
+    },
+    required: [],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const response = await client.me.tracks.list(body).asResponse();
+  return asTextContentResult(await response.json());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/tracks/remove-me-tracks.ts

@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'me.tracks',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/me/tracks',
+  operationId: 'remove-tracks-user',
+};
+
+export const tool: Tool = {
+  name: 'remove_me_tracks',
+  description: "Remove one or more tracks from the current user's 'Your Music' library.\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'array',
+        description:
+          'A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example: `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items can be specified in one request. _**Note**: if the `ids` parameter is present in the query string, any IDs listed here in the body will be ignored._\n',
+        items: {
+          type: 'string',
+        },
+      },
+    },
+    required: [],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const response = await client.me.tracks.remove(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/tracks/save-me-tracks.ts

@@ -0,0 +1,67 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'me.tracks',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/me/tracks',
+  operationId: 'save-tracks-user',
+};
+
+export const tool: Tool = {
+  name: 'save_me_tracks',
+  description: "Save one or more tracks to the current user's 'Your Music' library.\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'array',
+        description:
+          'A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example: `["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]`<br/>A maximum of 50 items can be specified in one request. _**Note**: if the `timestamped_ids` is present in the body, any IDs listed in the query parameters (deprecated) or the `ids` field in the body will be ignored._\n',
+        items: {
+          type: 'string',
+        },
+      },
+      timestamped_ids: {
+        type: 'array',
+        description:
+          "A JSON array of objects containing track IDs with their corresponding timestamps. Each object must include a track ID and an `added_at` timestamp. This allows you to specify when tracks were added to maintain a specific chronological order in the user's library.<br/>A maximum of 50 items can be specified in one request. _**Note**: if the `timestamped_ids` is present in the body, any IDs listed in the query parameters (deprecated) or the `ids` field in the body will be ignored._\n",
+        items: {
+          type: 'object',
+          properties: {
+            id: {
+              type: 'string',
+              description:
+                'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the track.\n',
+            },
+            added_at: {
+              type: 'string',
+              description:
+                "The timestamp when the track was added to the library. Use ISO 8601 format with UTC timezone (e.g., `2023-01-15T14:30:00Z`). You can specify past timestamps to insert tracks at specific positions in the library's chronological order. The API uses minute-level granularity for ordering, though the timestamp supports millisecond precision.\n",
+              format: 'date-time',
+            },
+          },
+          required: ['id', 'added_at'],
+        },
+      },
+    },
+    required: ['ids'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const response = await client.me.tracks.save(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/playlists/followers/check-playlists-followers.ts

@@ -0,0 +1,57 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'spotted-ts-mcp/filtering';
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'playlists.followers',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/playlists/{playlist_id}/followers/contains',
+  operationId: 'check-if-user-follows-playlist',
+};
+
+export const tool: Tool = {
+  name: 'check_playlists_followers',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCheck to see if the current user is following a specified playlist.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/follower_check_response',\n  $defs: {\n    follower_check_response: {\n      type: 'array',\n      items: {\n        type: 'boolean'\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      playlist_id: {
+        type: 'string',
+        title: 'Playlist ID',
+        description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playlist.\n',
+      },
+      ids: {
+        type: 'string',
+        title: 'Spotify user IDs',
+        description:
+          "**Deprecated** A single item list containing current user's [Spotify Username](/documentation/web-api/concepts/spotify-uris-ids). Maximum: 1 id.\n",
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['playlist_id'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const { playlist_id, jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await client.playlists.followers.check(playlist_id, body)),
+  );
+};
+
+export default { metadata, tool, handler };

package/src/tools/playlists/followers/follow-playlists-followers.ts

@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'playlists.followers',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/playlists/{playlist_id}/followers',
+  operationId: 'follow-playlist',
+};
+
+export const tool: Tool = {
+  name: 'follow_playlists_followers',
+  description: 'Add the current user as a follower of a playlist.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      playlist_id: {
+        type: 'string',
+        title: 'Playlist ID',
+        description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playlist.\n',
+      },
+      public: {
+        type: 'boolean',
+        description:
+          "Defaults to `true`. If `true` the playlist will be included in user's public playlists (added to profile), if `false` it will remain private. For more about public/private status, see [Working with Playlists](/documentation/web-api/concepts/playlists)\n",
+      },
+    },
+    required: ['playlist_id'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const { playlist_id, ...body } = args as any;
+  const response = await client.playlists.followers.follow(playlist_id, body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/playlists/followers/unfollow-playlists-followers.ts

@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'playlists.followers',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/playlists/{playlist_id}/followers',
+  operationId: 'unfollow-playlist',
+};
+
+export const tool: Tool = {
+  name: 'unfollow_playlists_followers',
+  description: 'Remove the current user as a follower of a playlist.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      playlist_id: {
+        type: 'string',
+        title: 'Playlist ID',
+        description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playlist.\n',
+      },
+    },
+    required: ['playlist_id'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const { playlist_id, ...body } = args as any;
+  const response = await client.playlists.followers.unfollow(playlist_id).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/playlists/images/list-playlists-images.ts

@@ -0,0 +1,49 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from 'spotted-ts-mcp/filtering';
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'playlists.images',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/playlists/{playlist_id}/images',
+  operationId: 'get-playlist-cover',
+};
+
+export const tool: Tool = {
+  name: 'list_playlists_images',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet the current image associated with a specific playlist.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/image_list_response',\n  $defs: {\n    image_list_response: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/image_object'\n      }\n    },\n    image_object: {\n      type: 'object',\n      properties: {\n        height: {\n          type: 'integer',\n          description: 'The image height in pixels.\\n'\n        },\n        url: {\n          type: 'string',\n          description: 'The source URL of the image.\\n'\n        },\n        width: {\n          type: 'integer',\n          description: 'The image width in pixels.\\n'\n        }\n      },\n      required: [        'height',\n        'url',\n        'width'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      playlist_id: {
+        type: 'string',
+        title: 'Playlist ID',
+        description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playlist.\n',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['playlist_id'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const { playlist_id, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.playlists.images.list(playlist_id)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/playlists/images/update-playlists-images.ts

@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'playlists.images',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/playlists/{playlist_id}/images',
+  operationId: 'upload-custom-playlist-cover',
+};
+
+export const tool: Tool = {
+  name: 'update_playlists_images',
+  description: 'Replace the image used to represent a specific playlist.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      playlist_id: {
+        type: 'string',
+        title: 'Playlist ID',
+        description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playlist.\n',
+      },
+      body: {
+        type: 'string',
+        description: 'Base64 encoded JPEG image data, maximum payload size is 256 KB.',
+      },
+    },
+    required: ['playlist_id', 'body'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const { playlist_id, ...body } = args as any;
+  const response = await client.playlists.images.update(playlist_id, body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/playlists/retrieve-playlists.ts

@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from 'spotted-ts-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+
+export const metadata: Metadata = {
+  resource: 'playlists',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/playlists/{playlist_id}',
+  operationId: 'get-playlist',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_playlists',
+  description: 'Get a playlist owned by a Spotify user.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      playlist_id: {
+        type: 'string',
+        title: 'Playlist ID',
+        description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the playlist.\n',
+      },
+      additional_types: {
+        type: 'string',
+        title: 'Additional Types',
+        description:
+          'A comma-separated list of item types that your client supports besides the default `track` type. Valid types are: `track` and `episode`.<br/>\n_**Note**: This parameter was introduced to allow existing clients to maintain their current behaviour and might be deprecated in the future._<br/>\nIn addition to providing this parameter, make sure that your client properly handles cases of new types in the future by checking against the `type` field of each object.\n',
+      },
+      fields: {
+        type: 'string',
+        title: 'Fields',
+        description:
+          "Filters for the query: a comma-separated list of the\nfields to return. If omitted, all fields are returned. For example, to get\njust the playlist''s description and URI: `fields=description,uri`. A dot\nseparator can be used to specify non-reoccurring fields, while parentheses\ncan be used to specify reoccurring fields within objects. For example, to\nget just the added date and user ID of the adder: `fields=tracks.items(added_at,added_by.id)`.\nUse multiple parentheses to drill down into nested objects, for example: `fields=tracks.items(track(name,href,album(name,href)))`.\nFields can be excluded by prefixing them with an exclamation mark, for example:\n`fields=tracks.items(track(name,href,album(!name,href)))`\n",
+      },
+      market: {
+        type: 'string',
+        title: 'Market',
+        description:
+          'An [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).\n  If a country code is specified, only content that is available in that market will be returned.<br/>\n  If a valid user access token is specified in the request header, the country associated with\n  the user account will take priority over this parameter.<br/>\n  _**Note**: If neither market or user country are provided, the content is considered unavailable for the client._<br/>\n  Users can view the country that is associated with their account in the [account settings](https://www.spotify.com/account/overview/).\n',
+      },
+    },
+    required: ['playlist_id'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const { playlist_id, ...body } = args as any;
+  return asTextContentResult(await client.playlists.retrieve(playlist_id, body));
+};
+
+export default { metadata, tool, handler };