spotted-ts-mcp 0.1.0

package/src/tools/me/player/set-volume-me-player.ts

@@ -0,0 +1,49 @@
+// 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.player',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/me/player/volume',
+  operationId: 'set-volume-for-users-playback',
+};
+
+export const tool: Tool = {
+  name: 'set_volume_me_player',
+  description:
+    'Set the volume for the user’s current playback device. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      volume_percent: {
+        type: 'integer',
+        title: 'Volume %',
+        description: 'The volume to set. Must be a value from 0 to 100 inclusive.\n',
+      },
+      device_id: {
+        type: 'string',
+        title: 'Device ID',
+        description:
+          "The id of the device this command is targeting. If not supplied, the user's currently active device is the target.\n",
+      },
+    },
+    required: ['volume_percent'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const response = await client.me.player.setVolume(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/player/skip-next-me-player.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: 'me.player',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/me/player/next',
+  operationId: 'skip-users-playback-to-next-track',
+};
+
+export const tool: Tool = {
+  name: 'skip_next_me_player',
+  description:
+    'Skips to next track in the user’s queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      device_id: {
+        type: 'string',
+        title: 'Device ID',
+        description:
+          "The id of the device this command is targeting. If not supplied, the user's currently active device is the target.",
+      },
+    },
+    required: [],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const response = await client.me.player.skipNext(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/player/skip-previous-me-player.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: 'me.player',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/me/player/previous',
+  operationId: 'skip-users-playback-to-previous-track',
+};
+
+export const tool: Tool = {
+  name: 'skip_previous_me_player',
+  description:
+    'Skips to previous track in the user’s queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      device_id: {
+        type: 'string',
+        title: 'Device ID',
+        description:
+          "The id of the device this command is targeting. If\nnot supplied, the user's currently active device is the target.\n",
+      },
+    },
+    required: [],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const response = await client.me.player.skipPrevious(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/player/start-playback-me-player.ts

@@ -0,0 +1,68 @@
+// 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.player',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/me/player/play',
+  operationId: 'start-a-users-playback',
+};
+
+export const tool: Tool = {
+  name: 'start_playback_me_player',
+  description:
+    "Start a new context or resume current playback on the user's active device. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      device_id: {
+        type: 'string',
+        title: 'Device ID',
+        description:
+          "The id of the device this command is targeting. If not supplied, the user's currently active device is the target.",
+      },
+      context_uri: {
+        type: 'string',
+        description:
+          'Optional. Spotify URI of the context to play.\nValid contexts are albums, artists & playlists.\n`{context_uri:"spotify:album:1Je1IMUlBXcx1Fz0WE7oPT"}`\n',
+      },
+      offset: {
+        type: 'object',
+        description:
+          'Optional. Indicates from where in the context playback should start. Only available when context_uri corresponds to an album or playlist object\n"position" is zero based and can’t be negative. Example: `"offset": {"position": 5}`\n"uri" is a string representing the uri of the item to start at. Example: `"offset": {"uri": "spotify:track:1301WleyT98MSxVHPZCA6M"}`\n',
+        additionalProperties: true,
+      },
+      position_ms: {
+        type: 'integer',
+        description:
+          'Indicates from what position to start playback. Must be a positive number. Passing in a position that is greater than the length of the track will cause the player to start playing the next song.\n',
+      },
+      uris: {
+        type: 'array',
+        description:
+          'Optional. A JSON array of the Spotify track URIs to play.\nFor example: `{"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh", "spotify:track:1301WleyT98MSxVHPZCA6M"]}`\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.player.startPlayback(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/player/toggle-shuffle-me-player.ts

@@ -0,0 +1,50 @@
+// 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.player',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/me/player/shuffle',
+  operationId: 'toggle-shuffle-for-users-playback',
+};
+
+export const tool: Tool = {
+  name: 'toggle_shuffle_me_player',
+  description:
+    'Toggle shuffle on or off for user’s playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      state: {
+        type: 'boolean',
+        title: 'State',
+        description:
+          "**true** : Shuffle user's playback.<br/>\n**false** : Do not shuffle user's playback.\n",
+      },
+      device_id: {
+        type: 'string',
+        title: 'Device ID',
+        description:
+          "The id of the device this command is targeting. If\nnot supplied, the user's currently active device is the target.\n",
+      },
+    },
+    required: ['state'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Spotted, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const response = await client.me.player.toggleShuffle(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/player/transfer-me-player.ts

@@ -0,0 +1,51 @@
+// 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.player',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/me/player',
+  operationId: 'transfer-a-users-playback',
+};
+
+export const tool: Tool = {
+  name: 'transfer_me_player',
+  description:
+    'Transfer playback to a new device and optionally begin playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.\n',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      device_ids: {
+        type: 'array',
+        description:
+          'A JSON array containing the ID of the device on which playback should be started/transferred.<br/>For example:`{device_ids:["74ASZWbe4lXaubB36ztrGX"]}`<br/>_**Note**: Although an array is accepted, only a single device_id is currently supported. Supplying more than one will return `400 Bad Request`_\n',
+        items: {
+          type: 'string',
+        },
+      },
+      play: {
+        type: 'boolean',
+        description:
+          '**true**: ensure playback happens on new device.<br/>**false** or not provided: keep the current playback state.\n',
+      },
+    },
+    required: ['device_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.player.transfer(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,56 @@
+// 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.playlists',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/playlists',
+  operationId: 'get-a-list-of-current-users-playlists',
+};
+
+export const tool: Tool = {
+  name: 'list_me_playlists',
+  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 a list of the playlists owned or followed by the current Spotify\nuser.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/paging_playlist_object',\n  $defs: {\n    paging_playlist_object: {\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/simplified_playlist_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    },\n    simplified_playlist_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 playlist.\\n'\n        },\n        collaborative: {\n          type: 'boolean',\n          description: '`true` if the owner allows other users to modify the playlist.\\n'\n        },\n        description: {\n          type: 'string',\n          description: 'The playlist description. _Only returned for modified, verified playlists, otherwise_ `null`.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the playlist.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'Images for the playlist. The array may be empty or contain up to three images. The images are returned by size in descending order. See [Working with Playlists](/documentation/web-api/concepts/playlists). _**Note**: If returned, the source URL for the image (`url`) is temporary and will expire in less than a day._\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the playlist.\\n'\n        },\n        owner: {\n          allOf: [            {\n              $ref: '#/$defs/playlist_user_object'\n            }\n          ],\n          description: 'The user who owns the playlist\\n'\n        },\n        public: {\n          type: 'boolean',\n          description: 'The playlist\\'s public/private status (if it is added to the user\\'s profile): `true` the playlist is public, `false` the playlist is private, `null` the playlist status is not relevant. For more about public/private status, see [Working with Playlists](/documentation/web-api/concepts/playlists)\\n'\n        },\n        snapshot_id: {\n          type: 'string',\n          description: 'The version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version\\n'\n        },\n        tracks: {\n          $ref: '#/$defs/playlist_tracks_ref_object'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type: \"playlist\"\\n'\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the playlist.\\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    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    playlist_user_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint for this user.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'user'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for this user.\\n'\n        }\n      }\n    },\n    playlist_tracks_ref_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint where full details of the playlist\\'s tracks can be retrieved.\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'Number of tracks in the playlist.\\n'\n        }\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 playlist to return. Default:\n0 (the first object). Maximum offset: 100.000\\. Use with `limit` to get the\nnext set of playlists.'\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.playlists.list(body).asResponse();
+  return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,44 @@
+// 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',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me',
+  operationId: 'get-current-users-profile',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_me',
+  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 detailed profile information about the current user (including the\ncurrent user's username).\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/me_retrieve_response',\n  $defs: {\n    me_retrieve_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify user ID](/documentation/web-api/concepts/spotify-uris-ids) for the user.\\n'\n        },\n        country: {\n          type: 'string',\n          description: 'The country of the user, as set in the user\\'s account profile. An [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). _This field is only available when the current user has granted access to the [user-read-private](/documentation/web-api/concepts/scopes/#list-of-scopes) scope._\\n'\n        },\n        display_name: {\n          type: 'string',\n          description: 'The name displayed on the user\\'s profile. `null` if not available.\\n'\n        },\n        email: {\n          type: 'string',\n          description: 'The user\\'s email address, as entered by the user when creating their account. _**Important!** This email address is unverified; there is no proof that it actually belongs to the user._ _This field is only available when the current user has granted access to the [user-read-email](/documentation/web-api/concepts/scopes/#list-of-scopes) scope._\\n'\n        },\n        explicit_content: {\n          type: 'object',\n          description: 'The user\\'s explicit content settings. _This field is only available when the current user has granted access to the [user-read-private](/documentation/web-api/concepts/scopes/#list-of-scopes) scope._\\n',\n          properties: {\n            filter_enabled: {\n              type: 'boolean',\n              description: 'When `true`, indicates that explicit content should not be played.\\n'\n            },\n            filter_locked: {\n              type: 'boolean',\n              description: 'When `true`, indicates that the explicit content setting is locked and can\\'t be changed by the user.\\n'\n            }\n          }\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        followers: {\n          $ref: '#/$defs/followers_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint for this user.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'The user\\'s profile image.',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        product: {\n          type: 'string',\n          description: 'The user\\'s Spotify subscription level: \"premium\", \"free\", etc. (The subscription level \"open\" can be considered the same as \"free\".) _This field is only available when the current user has granted access to the [user-read-private](/documentation/web-api/concepts/scopes/#list-of-scopes) scope._\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type: \"user\"\\n'\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the user.\\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: {
+      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 } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.me.retrieve()));
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/shows/check-me-shows.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.shows',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/shows/contains',
+  operationId: 'check-users-saved-shows',
+};
+
+export const tool: Tool = {
+  name: 'check_me_shows',
+  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 shows is already saved in the current Spotify user's library.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/show_check_response',\n  $defs: {\n    show_check_response: {\n      type: 'array',\n      items: {\n        type: 'boolean'\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'string',
+        title: 'Ids',
+        description:
+          'A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the shows. 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.shows.check(body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,56 @@
+// 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.shows',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/shows',
+  operationId: 'get-users-saved-shows',
+};
+
+export const tool: Tool = {
+  name: 'list_me_shows',
+  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 a list of shows saved in the current Spotify user's library. Optional parameters can be used to limit the number of shows returned.\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/show_list_response'\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    show_list_response: {\n      type: 'object',\n      properties: {\n        added_at: {\n          type: 'string',\n          description: 'The date and time the show was saved.\\nTimestamps are returned in ISO 8601 format as Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ.\\nIf the time is imprecise (for example, the date/time of an album release), an additional field indicates the precision; see for example, release_date in an album object.\\n',\n          format: 'date-time'\n        },\n        show: {\n          $ref: '#/$defs/show_base'\n        }\n      }\n    },\n    show_base: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the show.\\n'\n        },\n        available_markets: {\n          type: 'array',\n          description: 'A list of the countries in which the show can be played, identified by their [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code.\\n',\n          items: {\n            type: 'string'\n          }\n        },\n        copyrights: {\n          type: 'array',\n          description: 'The copyright statements of the show.\\n',\n          items: {\n            $ref: '#/$defs/copyright_object'\n          }\n        },\n        description: {\n          type: 'string',\n          description: 'A description of the show. HTML tags are stripped away from this field, use `html_description` field in case HTML tags are needed.\\n'\n        },\n        explicit: {\n          type: 'boolean',\n          description: 'Whether or not the show has explicit content (true = yes it does; false = no it does not OR unknown).\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the show.\\n'\n        },\n        html_description: {\n          type: 'string',\n          description: 'A description of the show. This field may contain HTML tags.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'The cover art for the show in various sizes, widest first.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        is_externally_hosted: {\n          type: 'boolean',\n          description: 'True if all of the shows episodes are hosted outside of Spotify\\'s CDN. This field might be `null` in some cases.\\n'\n        },\n        languages: {\n          type: 'array',\n          description: 'A list of the languages used in the show, identified by their [ISO 639](https://en.wikipedia.org/wiki/ISO_639) code.\\n',\n          items: {\n            type: 'string'\n          }\n        },\n        media_type: {\n          type: 'string',\n          description: 'The media type of the show.\\n'\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the episode.\\n'\n        },\n        publisher: {\n          type: 'string',\n          description: 'The publisher of the show.\\n'\n        },\n        total_episodes: {\n          type: 'integer',\n          description: 'The total number of episodes in the show.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'show'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the show.\\n'\n        }\n      },\n      required: [        'id',\n        'available_markets',\n        'copyrights',\n        'description',\n        'explicit',\n        'external_urls',\n        'href',\n        'html_description',\n        'images',\n        'is_externally_hosted',\n        'languages',\n        'media_type',\n        'name',\n        'publisher',\n        'total_episodes',\n        'type',\n        'uri'\n      ]\n    },\n    copyright_object: {\n      type: 'object',\n      properties: {\n        text: {\n          type: 'string',\n          description: 'The copyright text for this content.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The type of copyright: `C` = the copyright, `P` = the sound recording (performance) copyright.\\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    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',
+      },
+      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.shows.list(body).asResponse();
+  return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/shows/remove-me-shows.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.shows',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/me/shows',
+  operationId: 'remove-shows-user',
+};
+
+export const tool: Tool = {
+  name: 'remove_me_shows',
+  description: "Delete one or more shows from current Spotify user's library.\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'array',
+        description:
+          'A JSON array of the [Spotify IDs](https://developer.spotify.com/documentation/web-api/#spotify-uris-and-ids).  \nA 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.*',
+        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.shows.remove(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/shows/save-me-shows.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.shows',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/me/shows',
+  operationId: 'save-shows-user',
+};
+
+export const tool: Tool = {
+  name: 'save_me_shows',
+  description: "Save one or more shows to current Spotify user's library.\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'array',
+        description:
+          'A JSON array of the [Spotify IDs](https://developer.spotify.com/documentation/web-api/#spotify-uris-and-ids).  \nA 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.*',
+        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.shows.save(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };