spotted-ts-mcp 0.1.0

package/tools/browse/categories/get-playlists-browse-categories.d.ts

@@ -0,0 +1,45 @@
+import { Metadata } from 'spotted-ts-mcp/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=get-playlists-browse-categories.d.ts.map

package/tools/browse/categories/get-playlists-browse-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-playlists-browse-categories.d.ts","sourceRoot":"","sources":["../../../src/tools/browse/categories/get-playlists-browse-categories.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,OAAO,MAAM,YAAY;AAEhC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAoClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAKvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBALoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAOxF,wBAA2C"}

package/tools/browse/categories/get-playlists-browse-categories.js

@@ -0,0 +1,54 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("spotted-ts-mcp/filtering");
+const types_1 = require("spotted-ts-mcp/tools/types");
+exports.metadata = {
+    resource: 'browse.categories',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/browse/categories/{category_id}/playlists',
+    operationId: 'get-a-categories-playlists',
+};
+exports.tool = {
+    name: 'get_playlists_browse_categories',
+    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 Spotify playlists tagged with a particular category.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/category_get_playlists_response',\n  $defs: {\n    category_get_playlists_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string',\n          description: 'The localized message of a playlist.\\n'\n        },\n        playlists: {\n          $ref: '#/$defs/paging_playlist_object'\n        }\n      }\n    },\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: {
+            category_id: {
+                type: 'string',
+                title: 'Category ID',
+                description: 'The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) for the category.\n',
+            },
+            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: ['category_id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+const handler = async (client, args) => {
+    const { category_id, jq_filter, ...body } = args;
+    return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.browse.categories.getPlaylists(category_id, body)));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=get-playlists-browse-categories.js.map

package/tools/browse/categories/get-playlists-browse-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-playlists-browse-categories.js","sourceRoot":"","sources":["../../../src/tools/browse/categories/get-playlists-browse-categories.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,4CAA4C;IACtD,WAAW,EAAE,4BAA4B;CAC1C,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,o2MAAo2M;IACt2M,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,aAAa;gBACpB,WAAW,EACT,iGAAiG;aACpG;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,gFAAgF;aAC9F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,oHAAoH;aACvH;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACxD,OAAO,IAAA,2BAAmB,EACxB,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAC7F,CAAC;AACJ,CAAC,CAAC;AALW,QAAA,OAAO,WAKlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/browse/categories/get-playlists-browse-categories.mjs

@@ -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 { asTextContentResult } from 'spotted-ts-mcp/tools/types';
+export const metadata = {
+    resource: 'browse.categories',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/browse/categories/{category_id}/playlists',
+    operationId: 'get-a-categories-playlists',
+};
+export const tool = {
+    name: 'get_playlists_browse_categories',
+    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 Spotify playlists tagged with a particular category.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/category_get_playlists_response',\n  $defs: {\n    category_get_playlists_response: {\n      type: 'object',\n      properties: {\n        message: {\n          type: 'string',\n          description: 'The localized message of a playlist.\\n'\n        },\n        playlists: {\n          $ref: '#/$defs/paging_playlist_object'\n        }\n      }\n    },\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: {
+            category_id: {
+                type: 'string',
+                title: 'Category ID',
+                description: 'The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) for the category.\n',
+            },
+            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: ['category_id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+export const handler = async (client, args) => {
+    const { category_id, jq_filter, ...body } = args;
+    return asTextContentResult(await maybeFilter(jq_filter, await client.browse.categories.getPlaylists(category_id, body)));
+};
+export default { metadata, tool, handler };
+//# sourceMappingURL=get-playlists-browse-categories.mjs.map

package/tools/browse/categories/get-playlists-browse-categories.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-playlists-browse-categories.mjs","sourceRoot":"","sources":["../../../src/tools/browse/categories/get-playlists-browse-categories.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,4CAA4C;IACtD,WAAW,EAAE,4BAA4B;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,o2MAAo2M;IACt2M,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,aAAa;gBACpB,WAAW,EACT,iGAAiG;aACpG;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,gFAAgF;aAC9F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,oHAAoH;aACvH;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACxD,OAAO,mBAAmB,CACxB,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAC7F,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/browse/categories/list-browse-categories.d.mts

@@ -0,0 +1,45 @@
+import { Metadata } from 'spotted-ts-mcp/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=list-browse-categories.d.mts.map

package/tools/browse/categories/list-browse-categories.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-browse-categories.d.mts","sourceRoot":"","sources":["../../../src/tools/browse/categories/list-browse-categories.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,OAAO,MAAM,YAAY;AAEhC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAoClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAGvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAKxF,wBAA2C"}

package/tools/browse/categories/list-browse-categories.d.ts

@@ -0,0 +1,45 @@
+import { Metadata } from 'spotted-ts-mcp/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=list-browse-categories.d.ts.map

package/tools/browse/categories/list-browse-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-browse-categories.d.ts","sourceRoot":"","sources":["../../../src/tools/browse/categories/list-browse-categories.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,OAAO,MAAM,YAAY;AAEhC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAoClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAGvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAKxF,wBAA2C"}

package/tools/browse/categories/list-browse-categories.js

@@ -0,0 +1,54 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("spotted-ts-mcp/filtering");
+const types_1 = require("spotted-ts-mcp/tools/types");
+exports.metadata = {
+    resource: 'browse.categories',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/browse/categories',
+    operationId: 'get-categories',
+};
+exports.tool = {
+    name: 'list_browse_categories',
+    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 categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/category_list_response',\n  $defs: {\n    category_list_response: {\n      type: 'object',\n      properties: {\n        categories: {\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                type: 'object',\n                properties: {\n                  id: {\n                    type: 'string',\n                    description: 'The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of the category.\\n'\n                  },\n                  href: {\n                    type: 'string',\n                    description: 'A link to the Web API endpoint returning full details of the category.\\n'\n                  },\n                  icons: {\n                    type: 'array',\n                    description: 'The category icon, in various sizes.\\n',\n                    items: {\n                      $ref: '#/$defs/image_object'\n                    }\n                  },\n                  name: {\n                    type: 'string',\n                    description: 'The name of the category.\\n'\n                  }\n                },\n                required: [                  'id',\n                  'href',\n                  'icons',\n                  'name'\n                ]\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      },\n      required: [        'categories'\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',
+            },
+            locale: {
+                type: 'string',
+                title: 'Locale',
+                description: 'The desired language, consisting of an [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), joined by an underscore. For example: `es_MX`, meaning &quot;Spanish (Mexico)&quot;. Provide this parameter if you want the category strings returned in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the specified language is not available, the category strings returned will be in the Spotify default language (American English)._\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,
+    },
+};
+const handler = async (client, args) => {
+    const { jq_filter, ...body } = args;
+    return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.browse.categories.list(body)));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=list-browse-categories.js.map

package/tools/browse/categories/list-browse-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-browse-categories.js","sourceRoot":"","sources":["../../../src/tools/browse/categories/list-browse-categories.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,oBAAoB;IAC9B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,k5GAAk5G;IACp5G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,gFAAgF;aAC9F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,8iBAA8iB;aACjjB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,oHAAoH;aACvH;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtG,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/browse/categories/list-browse-categories.mjs

@@ -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 { asTextContentResult } from 'spotted-ts-mcp/tools/types';
+export const metadata = {
+    resource: 'browse.categories',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/browse/categories',
+    operationId: 'get-categories',
+};
+export const tool = {
+    name: 'list_browse_categories',
+    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 categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/category_list_response',\n  $defs: {\n    category_list_response: {\n      type: 'object',\n      properties: {\n        categories: {\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                type: 'object',\n                properties: {\n                  id: {\n                    type: 'string',\n                    description: 'The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of the category.\\n'\n                  },\n                  href: {\n                    type: 'string',\n                    description: 'A link to the Web API endpoint returning full details of the category.\\n'\n                  },\n                  icons: {\n                    type: 'array',\n                    description: 'The category icon, in various sizes.\\n',\n                    items: {\n                      $ref: '#/$defs/image_object'\n                    }\n                  },\n                  name: {\n                    type: 'string',\n                    description: 'The name of the category.\\n'\n                  }\n                },\n                required: [                  'id',\n                  'href',\n                  'icons',\n                  'name'\n                ]\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      },\n      required: [        'categories'\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',
+            },
+            locale: {
+                type: 'string',
+                title: 'Locale',
+                description: 'The desired language, consisting of an [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), joined by an underscore. For example: `es_MX`, meaning &quot;Spanish (Mexico)&quot;. Provide this parameter if you want the category strings returned in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the specified language is not available, the category strings returned will be in the Spotify default language (American English)._\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, args) => {
+    const { jq_filter, ...body } = args;
+    return asTextContentResult(await maybeFilter(jq_filter, await client.browse.categories.list(body)));
+};
+export default { metadata, tool, handler };
+//# sourceMappingURL=list-browse-categories.mjs.map

package/tools/browse/categories/list-browse-categories.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-browse-categories.mjs","sourceRoot":"","sources":["../../../src/tools/browse/categories/list-browse-categories.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE,MAAM,0BAA0B;OAC/C,EAAY,mBAAmB,EAAE,MAAM,4BAA4B;AAK1E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,oBAAoB;IAC9B,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,k5GAAk5G;IACp5G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,gFAAgF;aAC9F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,8iBAA8iB;aACjjB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,oHAAoH;aACvH;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC3C,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtG,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/browse/categories/retrieve-browse-categories.d.mts

@@ -0,0 +1,45 @@
+import { Metadata } from 'spotted-ts-mcp/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=retrieve-browse-categories.d.mts.map

package/tools/browse/categories/retrieve-browse-categories.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-browse-categories.d.mts","sourceRoot":"","sources":["../../../src/tools/browse/categories/retrieve-browse-categories.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,OAAO,MAAM,YAAY;AAEhC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA+BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAKvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBALoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAOxF,wBAA2C"}

package/tools/browse/categories/retrieve-browse-categories.d.ts

@@ -0,0 +1,45 @@
+import { Metadata } from 'spotted-ts-mcp/tools/types';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Spotted from 'spotted-ts';
+export declare const metadata: Metadata;
+export declare const tool: Tool;
+export declare const handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+declare const _default: {
+    metadata: Metadata;
+    tool: {
+        [x: string]: unknown;
+        name: string;
+        inputSchema: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        };
+        title?: string | undefined;
+        description?: string | undefined;
+        outputSchema?: {
+            [x: string]: unknown;
+            type: "object";
+            properties?: {
+                [x: string]: unknown;
+            } | undefined;
+            required?: string[] | undefined;
+        } | undefined;
+        annotations?: {
+            [x: string]: unknown;
+            title?: string | undefined;
+            readOnlyHint?: boolean | undefined;
+            destructiveHint?: boolean | undefined;
+            idempotentHint?: boolean | undefined;
+            openWorldHint?: boolean | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    };
+    handler: (client: Spotted, args: Record<string, unknown> | undefined) => Promise<import("spotted-ts-mcp/tools/types").ToolCallResult>;
+};
+export default _default;
+//# sourceMappingURL=retrieve-browse-categories.d.ts.map

package/tools/browse/categories/retrieve-browse-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-browse-categories.d.ts","sourceRoot":"","sources":["../../../src/tools/browse/categories/retrieve-browse-categories.ts"],"names":[],"mappings":"OAGO,EAAE,QAAQ,EAAuB,MAAM,4BAA4B;OAEnE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,OAAO,MAAM,YAAY;AAEhC,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA+BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAKvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBALoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAOxF,wBAA2C"}

package/tools/browse/categories/retrieve-browse-categories.js

@@ -0,0 +1,49 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.tool = exports.metadata = void 0;
+const filtering_1 = require("spotted-ts-mcp/filtering");
+const types_1 = require("spotted-ts-mcp/tools/types");
+exports.metadata = {
+    resource: 'browse.categories',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/browse/categories/{category_id}',
+    operationId: 'get-a-category',
+};
+exports.tool = {
+    name: 'retrieve_browse_categories',
+    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 single category used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/category_retrieve_response',\n  $defs: {\n    category_retrieve_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) of the category.\\n'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint returning full details of the category.\\n'\n        },\n        icons: {\n          type: 'array',\n          description: 'The category icon, in various sizes.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the category.\\n'\n        }\n      },\n      required: [        'id',\n        'href',\n        'icons',\n        'name'\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: {
+            category_id: {
+                type: 'string',
+                title: 'Category ID',
+                description: 'The [Spotify category ID](/documentation/web-api/concepts/spotify-uris-ids) for the category.\n',
+            },
+            locale: {
+                type: 'string',
+                title: 'Locale',
+                description: 'The desired language, consisting of an [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code and an [ISO 3166-1 alpha-2 country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), joined by an underscore. For example: `es_MX`, meaning &quot;Spanish (Mexico)&quot;. Provide this parameter if you want the category strings returned in a particular language.<br/> _**Note**: if `locale` is not supplied, or if the specified language is not available, the category strings returned will be in the Spotify default language (American English)._\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: ['category_id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+const handler = async (client, args) => {
+    const { category_id, jq_filter, ...body } = args;
+    return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.browse.categories.retrieve(category_id, body)));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=retrieve-browse-categories.js.map

package/tools/browse/categories/retrieve-browse-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-browse-categories.js","sourceRoot":"","sources":["../../../src/tools/browse/categories/retrieve-browse-categories.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,kCAAkC;IAC5C,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,grDAAgrD;IAClrD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,aAAa;gBACpB,WAAW,EACT,iGAAiG;aACpG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,QAAQ;gBACf,WAAW,EACT,8iBAA8iB;aACjjB;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACxD,OAAO,IAAA,2BAAmB,EACxB,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CACzF,CAAC;AACJ,CAAC,CAAC;AALW,QAAA,OAAO,WAKlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}