spotted-ts-mcp 0.1.0

package/src/tools/markets/list-markets.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: 'markets',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/markets',
+  operationId: 'get-available-markets',
+};
+
+export const tool: Tool = {
+  name: 'list_markets',
+  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 list of markets where Spotify is available.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/market_list_response',\n  $defs: {\n    market_list_response: {\n      type: 'object',\n      properties: {\n        markets: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        }\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.markets.list()));
+};
+
+export default { metadata, tool, handler };

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

package/src/tools/me/albums/list-me-albums.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.albums',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/albums',
+  operationId: 'get-users-saved-albums',
+};
+
+export const tool: Tool = {
+  name: 'list_me_albums',
+  description: "Get a list of the albums 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.albums.list(body).asResponse();
+  return asTextContentResult(await response.json());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/albums/remove-me-albums.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.albums',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/me/albums',
+  operationId: 'remove-albums-user',
+};
+
+export const tool: Tool = {
+  name: 'remove_me_albums',
+  description: "Remove one or more albums 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.albums.remove(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/albums/save-me-albums.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.albums',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/me/albums',
+  operationId: 'save-albums-user',
+};
+
+export const tool: Tool = {
+  name: 'save_me_albums',
+  description: "Save one or more albums 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 `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.albums.save(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

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

package/src/tools/me/audiobooks/list-me-audiobooks.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.audiobooks',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/audiobooks',
+  operationId: 'get-users-saved-audiobooks',
+};
+
+export const tool: Tool = {
+  name: 'list_me_audiobooks',
+  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 audiobooks saved in the current Spotify user's 'Your Music' library.\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/audiobook_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    audiobook_list_response: {\n      type: 'object',\n      properties: {\n        added_at: {\n          type: 'string',\n          description: 'The date and time the audiobook 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        audiobook: {\n          allOf: [            {\n              $ref: '#/$defs/audiobook_base'\n            }\n          ],\n          description: 'Information about the audiobook.'\n        }\n      }\n    },\n    audiobook_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 audiobook.\\n'\n        },\n        authors: {\n          type: 'array',\n          description: 'The author(s) for the audiobook.\\n',\n          items: {\n            $ref: '#/$defs/author_object'\n          }\n        },\n        available_markets: {\n          type: 'array',\n          description: 'A list of the countries in which the audiobook 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 audiobook.\\n',\n          items: {\n            $ref: '#/$defs/copyright_object'\n          }\n        },\n        description: {\n          type: 'string',\n          description: 'A description of the audiobook. 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 audiobook 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 audiobook.\\n'\n        },\n        html_description: {\n          type: 'string',\n          description: 'A description of the audiobook. This field may contain HTML tags.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'The cover art for the audiobook in various sizes, widest first.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        languages: {\n          type: 'array',\n          description: 'A list of the languages used in the audiobook, 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 audiobook.\\n'\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the audiobook.\\n'\n        },\n        narrators: {\n          type: 'array',\n          description: 'The narrator(s) for the audiobook.\\n',\n          items: {\n            $ref: '#/$defs/narrator_object'\n          }\n        },\n        publisher: {\n          type: 'string',\n          description: 'The publisher of the audiobook.\\n'\n        },\n        total_chapters: {\n          type: 'integer',\n          description: 'The number of chapters in this audiobook.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'audiobook'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the audiobook.\\n'\n        },\n        edition: {\n          type: 'string',\n          description: 'The edition of the audiobook.\\n'\n        }\n      },\n      required: [        'id',\n        'authors',\n        'available_markets',\n        'copyrights',\n        'description',\n        'explicit',\n        'external_urls',\n        'href',\n        'html_description',\n        'images',\n        'languages',\n        'media_type',\n        'name',\n        'narrators',\n        'publisher',\n        'total_chapters',\n        'type',\n        'uri'\n      ]\n    },\n    author_object: {\n      type: 'object',\n      properties: {\n        name: {\n          type: 'string',\n          description: 'The name of the author.\\n'\n        }\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    narrator_object: {\n      type: 'object',\n      properties: {\n        name: {\n          type: 'string',\n          description: 'The name of the Narrator.\\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 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.audiobooks.list(body).asResponse();
+  return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,43 @@
+// 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.audiobooks',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/me/audiobooks',
+  operationId: 'remove-audiobooks-user',
+};
+
+export const tool: Tool = {
+  name: 'remove_me_audiobooks',
+  description: "Remove one or more audiobooks from the Spotify user's library.\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'string',
+        title: 'Spotify Audiobook IDs',
+        description:
+          'A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example: `ids=18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ`. Maximum: 50 IDs.\n',
+      },
+    },
+    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.audiobooks.remove(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,43 @@
+// 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.audiobooks',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/me/audiobooks',
+  operationId: 'save-audiobooks-user',
+};
+
+export const tool: Tool = {
+  name: 'save_me_audiobooks',
+  description: "Save one or more audiobooks to the current Spotify user's library.\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'string',
+        title: 'Spotify Audiobook IDs',
+        description:
+          'A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). For example: `ids=18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ`. Maximum: 50 IDs.\n',
+      },
+    },
+    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.audiobooks.save(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/episodes/check-me-episodes.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.episodes',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/episodes/contains',
+  operationId: 'check-users-saved-episodes',
+};
+
+export const tool: Tool = {
+  name: 'check_me_episodes',
+  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 episodes is already saved in the current Spotify user's 'Your Episodes' library.<br/>\nThis API endpoint is in __beta__ and could change without warning. Please share any feedback that you have, or issues that you discover, in our [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer)..\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/episode_check_response',\n  $defs: {\n    episode_check_response: {\n      type: 'array',\n      items: {\n        type: 'boolean'\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'string',
+        title: 'Spotify Episode IDs',
+        description:
+          'A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the episodes. 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.episodes.check(body)));
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,55 @@
+// 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.episodes',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/me/episodes',
+  operationId: 'get-users-saved-episodes',
+};
+
+export const tool: Tool = {
+  name: 'list_me_episodes',
+  description:
+    "Get a list of the episodes saved in the current Spotify user's library.<br/>\nThis API endpoint is in __beta__ and could change without warning. Please share any feedback that you have, or issues that you discover, in our [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer).\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.episodes.list(body).asResponse();
+  return asTextContentResult(await response.json());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/episodes/remove-me-episodes.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: 'me.episodes',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/me/episodes',
+  operationId: 'remove-episodes-user',
+};
+
+export const tool: Tool = {
+  name: 'remove_me_episodes',
+  description:
+    "Remove one or more episodes from the current user's library.<br/>\nThis API endpoint is in __beta__ and could change without warning. Please share any feedback that you have, or issues that you discover, in our [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer).\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'array',
+        description:
+          'A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). <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.episodes.remove(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/me/episodes/save-me-episodes.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: 'me.episodes',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'put',
+  httpPath: '/me/episodes',
+  operationId: 'save-episodes-user',
+};
+
+export const tool: Tool = {
+  name: 'save_me_episodes',
+  description:
+    "Save one or more episodes to the current user's library.<br/>\nThis API endpoint is in __beta__ and could change without warning. Please share any feedback that you have, or issues that you discover, in our [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer).\n",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ids: {
+        type: 'array',
+        description:
+          'A JSON array of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids). <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: ['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.episodes.save(body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };