spotted-ts-mcp 0.1.0

package/tools/artists/list-albums-artists.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-albums-artists.d.ts.map

package/tools/artists/list-albums-artists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-albums-artists.d.ts","sourceRoot":"","sources":["../../src/tools/artists/list-albums-artists.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+ClB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iEAIvF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAJoC,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAMxF,wBAA2C"}

package/tools/artists/list-albums-artists.js

@@ -0,0 +1,65 @@
+"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: 'artists',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/artists/{id}/albums',
+    operationId: 'get-an-artists-albums',
+};
+exports.tool = {
+    name: 'list_albums_artists',
+    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 Spotify catalog information about an artist's albums.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    href: {\n      type: 'string',\n      description: 'A link to the Web API endpoint returning the full result of the request\\n'\n    },\n    items: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/artist_list_albums_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    artist_list_albums_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the album.\\n'\n        },\n        album_group: {\n          type: 'string',\n          description: 'This field describes the relationship between the artist and the album.',\n          enum: [            'album',\n            'single',\n            'compilation',\n            'appears_on'\n          ]\n        },\n        album_type: {\n          type: 'string',\n          description: 'The type of the album.',\n          enum: [            'album',\n            'single',\n            'compilation'\n          ]\n        },\n        artists: {\n          type: 'array',\n          description: 'The artists of the album. Each artist object includes a link in `href` to more detailed information about the artist.\\n',\n          items: {\n            $ref: '#/$defs/simplified_artist_object'\n          }\n        },\n        available_markets: {\n          type: 'array',\n          description: 'The markets in which the album is available: [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). _**NOTE**: an album is considered available in a market when at least 1 of its tracks is available in that market._\\n',\n          items: {\n            type: 'string'\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 album.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'The cover art for the album in various sizes, widest first.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the album. In case of an album takedown, the value may be an empty string.\\n'\n        },\n        release_date: {\n          type: 'string',\n          description: 'The date the album was first released.\\n'\n        },\n        release_date_precision: {\n          type: 'string',\n          description: 'The precision with which `release_date` value is known.',\n          enum: [            'year',\n            'month',\n            'day'\n          ]\n        },\n        total_tracks: {\n          type: 'integer',\n          description: 'The number of tracks in the album.'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'album'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the album.\\n'\n        },\n        restrictions: {\n          $ref: '#/$defs/album_restriction_object'\n        }\n      },\n      required: [        'id',\n        'album_group',\n        'album_type',\n        'artists',\n        'available_markets',\n        'external_urls',\n        'href',\n        'images',\n        'name',\n        'release_date',\n        'release_date_precision',\n        'total_tracks',\n        'type',\n        'uri'\n      ]\n    },\n    simplified_artist_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the artist.\\n'\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the artist.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'artist'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    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    album_restriction_object: {\n      type: 'object',\n      properties: {\n        reason: {\n          type: 'string',\n          description: 'The reason for the restriction. Albums may be restricted if the content is not available in a given market, to the user\\'s subscription type, or when the user\\'s account is set to not play explicit content.\\nAdditional reasons may be added in the future.',\n          enum: [            'market',\n            'product',\n            'explicit'\n          ]\n        }\n      }\n    }\n  }\n}\n```",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                title: 'Spotify Artist ID',
+                description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the artist.\n',
+            },
+            include_groups: {
+                type: 'string',
+                title: 'Groups to include (single, album, appears_on, compilation)',
+                description: 'A comma-separated list of keywords that will be used to filter the response. If not supplied, all album types will be returned. <br/>\nValid values are:<br/>- `album`<br/>- `single`<br/>- `appears_on`<br/>- `compilation`<br/>For example: `include_groups=album,single`.\n',
+            },
+            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',
+            },
+            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: ['id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+const handler = async (client, args) => {
+    const { id, jq_filter, ...body } = args;
+    const response = await client.artists.listAlbums(id, body).asResponse();
+    return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await response.json()));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=list-albums-artists.js.map

package/tools/artists/list-albums-artists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-albums-artists.js","sourceRoot":"","sources":["../../src/tools/artists/list-albums-artists.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,sBAAsB;IAChC,WAAW,EAAE,uBAAuB;CACrC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,uxNAAuxN;IACzxN,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,mBAAmB;gBAC1B,WAAW,EAAE,qFAAqF;aACnG;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,4DAA4D;gBACnE,WAAW,EACT,gRAAgR;aACnR;YACD,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,wmBAAwmB;aAC3mB;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,IAAI,CAAC;KACjB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACxE,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAJW,QAAA,OAAO,WAIlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/artists/list-albums-artists.mjs

@@ -0,0 +1,61 @@
+// 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: 'artists',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/artists/{id}/albums',
+    operationId: 'get-an-artists-albums',
+};
+export const tool = {
+    name: 'list_albums_artists',
+    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 Spotify catalog information about an artist's albums.\n\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    href: {\n      type: 'string',\n      description: 'A link to the Web API endpoint returning the full result of the request\\n'\n    },\n    items: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/artist_list_albums_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    artist_list_albums_response: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the album.\\n'\n        },\n        album_group: {\n          type: 'string',\n          description: 'This field describes the relationship between the artist and the album.',\n          enum: [            'album',\n            'single',\n            'compilation',\n            'appears_on'\n          ]\n        },\n        album_type: {\n          type: 'string',\n          description: 'The type of the album.',\n          enum: [            'album',\n            'single',\n            'compilation'\n          ]\n        },\n        artists: {\n          type: 'array',\n          description: 'The artists of the album. Each artist object includes a link in `href` to more detailed information about the artist.\\n',\n          items: {\n            $ref: '#/$defs/simplified_artist_object'\n          }\n        },\n        available_markets: {\n          type: 'array',\n          description: 'The markets in which the album is available: [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). _**NOTE**: an album is considered available in a market when at least 1 of its tracks is available in that market._\\n',\n          items: {\n            type: 'string'\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 album.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'The cover art for the album in various sizes, widest first.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the album. In case of an album takedown, the value may be an empty string.\\n'\n        },\n        release_date: {\n          type: 'string',\n          description: 'The date the album was first released.\\n'\n        },\n        release_date_precision: {\n          type: 'string',\n          description: 'The precision with which `release_date` value is known.',\n          enum: [            'year',\n            'month',\n            'day'\n          ]\n        },\n        total_tracks: {\n          type: 'integer',\n          description: 'The number of tracks in the album.'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'album'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the album.\\n'\n        },\n        restrictions: {\n          $ref: '#/$defs/album_restriction_object'\n        }\n      },\n      required: [        'id',\n        'album_group',\n        'album_type',\n        'artists',\n        'available_markets',\n        'external_urls',\n        'href',\n        'images',\n        'name',\n        'release_date',\n        'release_date_precision',\n        'total_tracks',\n        'type',\n        'uri'\n      ]\n    },\n    simplified_artist_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the artist.\\n'\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the artist.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'artist'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    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    album_restriction_object: {\n      type: 'object',\n      properties: {\n        reason: {\n          type: 'string',\n          description: 'The reason for the restriction. Albums may be restricted if the content is not available in a given market, to the user\\'s subscription type, or when the user\\'s account is set to not play explicit content.\\nAdditional reasons may be added in the future.',\n          enum: [            'market',\n            'product',\n            'explicit'\n          ]\n        }\n      }\n    }\n  }\n}\n```",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                title: 'Spotify Artist ID',
+                description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the artist.\n',
+            },
+            include_groups: {
+                type: 'string',
+                title: 'Groups to include (single, album, appears_on, compilation)',
+                description: 'A comma-separated list of keywords that will be used to filter the response. If not supplied, all album types will be returned. <br/>\nValid values are:<br/>- `album`<br/>- `single`<br/>- `appears_on`<br/>- `compilation`<br/>For example: `include_groups=album,single`.\n',
+            },
+            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',
+            },
+            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: ['id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+export const handler = async (client, args) => {
+    const { id, jq_filter, ...body } = args;
+    const response = await client.artists.listAlbums(id, body).asResponse();
+    return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+};
+export default { metadata, tool, handler };
+//# sourceMappingURL=list-albums-artists.mjs.map

package/tools/artists/list-albums-artists.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-albums-artists.mjs","sourceRoot":"","sources":["../../src/tools/artists/list-albums-artists.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,SAAS;IACnB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,sBAAsB;IAChC,WAAW,EAAE,uBAAuB;CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,uxNAAuxN;IACzxN,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,mBAAmB;gBAC1B,WAAW,EAAE,qFAAqF;aACnG;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,4DAA4D;gBACnE,WAAW,EACT,gRAAgR;aACnR;YACD,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,wmBAAwmB;aAC3mB;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,IAAI,CAAC;KACjB;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,EAAE,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IACxE,OAAO,mBAAmB,CAAC,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/artists/list-artists.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-artists.d.mts.map

package/tools/artists/list-artists.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-artists.d.mts","sourceRoot":"","sources":["../../src/tools/artists/list-artists.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,IAyBlB,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/artists/list-artists.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-artists.d.ts.map

package/tools/artists/list-artists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-artists.d.ts","sourceRoot":"","sources":["../../src/tools/artists/list-artists.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,IAyBlB,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/artists/list-artists.js

@@ -0,0 +1,44 @@
+"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: 'artists',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/artists',
+    operationId: 'get-multiple-artists',
+};
+exports.tool = {
+    name: 'list_artists',
+    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 Spotify catalog information for several artists based on their Spotify IDs.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/artist_list_response',\n  $defs: {\n    artist_list_response: {\n      type: 'object',\n      properties: {\n        artists: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/artist_object'\n          }\n        }\n      },\n      required: [        'artists'\n      ]\n    },\n    artist_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        followers: {\n          $ref: '#/$defs/followers_object'\n        },\n        genres: {\n          type: 'array',\n          description: 'A list of the genres the artist is associated with. If not yet classified, the array is empty.\\n',\n          items: {\n            type: 'string'\n          }\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the artist.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'Images of the artist in various sizes, widest first.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the artist.\\n'\n        },\n        popularity: {\n          type: 'integer',\n          description: 'The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist\\'s popularity is calculated from the popularity of all the artist\\'s tracks.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'artist'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    followers_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'This will always be set to null, as the Web API does not support it at the moment.\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'The total number of followers.\\n'\n        }\n      }\n    },\n    image_object: {\n      type: 'object',\n      properties: {\n        height: {\n          type: 'integer',\n          description: 'The image height in pixels.\\n'\n        },\n        url: {\n          type: 'string',\n          description: 'The source URL of the image.\\n'\n        },\n        width: {\n          type: 'integer',\n          description: 'The image width in pixels.\\n'\n        }\n      },\n      required: [        'height',\n        'url',\n        'width'\n      ]\n    }\n  }\n}\n```",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ids: {
+                type: 'string',
+                title: 'Spotify Artist IDs',
+                description: 'A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the artists. 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,
+    },
+};
+const handler = async (client, args) => {
+    const { jq_filter, ...body } = args;
+    return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.artists.list(body)));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=list-artists.js.map

package/tools/artists/list-artists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-artists.js","sourceRoot":"","sources":["../../src/tools/artists/list-artists.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,85GAA85G;IACh6G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,oBAAoB;gBAC3B,WAAW,EACT,mIAAmI;aACtI;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;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,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/artists/list-artists.mjs

@@ -0,0 +1,40 @@
+// 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: 'artists',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/artists',
+    operationId: 'get-multiple-artists',
+};
+export const tool = {
+    name: 'list_artists',
+    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 Spotify catalog information for several artists based on their Spotify IDs.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/artist_list_response',\n  $defs: {\n    artist_list_response: {\n      type: 'object',\n      properties: {\n        artists: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/artist_object'\n          }\n        }\n      },\n      required: [        'artists'\n      ]\n    },\n    artist_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        followers: {\n          $ref: '#/$defs/followers_object'\n        },\n        genres: {\n          type: 'array',\n          description: 'A list of the genres the artist is associated with. If not yet classified, the array is empty.\\n',\n          items: {\n            type: 'string'\n          }\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the artist.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'Images of the artist in various sizes, widest first.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the artist.\\n'\n        },\n        popularity: {\n          type: 'integer',\n          description: 'The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist\\'s popularity is calculated from the popularity of all the artist\\'s tracks.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'artist'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    followers_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'This will always be set to null, as the Web API does not support it at the moment.\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'The total number of followers.\\n'\n        }\n      }\n    },\n    image_object: {\n      type: 'object',\n      properties: {\n        height: {\n          type: 'integer',\n          description: 'The image height in pixels.\\n'\n        },\n        url: {\n          type: 'string',\n          description: 'The source URL of the image.\\n'\n        },\n        width: {\n          type: 'integer',\n          description: 'The image width in pixels.\\n'\n        }\n      },\n      required: [        'height',\n        'url',\n        'width'\n      ]\n    }\n  }\n}\n```",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            ids: {
+                type: 'string',
+                title: 'Spotify Artist IDs',
+                description: 'A comma-separated list of the [Spotify IDs](/documentation/web-api/concepts/spotify-uris-ids) for the artists. 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, args) => {
+    const { jq_filter, ...body } = args;
+    return asTextContentResult(await maybeFilter(jq_filter, await client.artists.list(body)));
+};
+export default { metadata, tool, handler };
+//# sourceMappingURL=list-artists.mjs.map

package/tools/artists/list-artists.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-artists.mjs","sourceRoot":"","sources":["../../src/tools/artists/list-artists.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,SAAS;IACnB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,85GAA85G;IACh6G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,oBAAoB;gBAC3B,WAAW,EACT,mIAAmI;aACtI;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;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,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/artists/list-related-artists-artists.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-related-artists-artists.d.mts.map

package/tools/artists/list-related-artists-artists.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-related-artists-artists.d.mts","sourceRoot":"","sources":["../../src/tools/artists/list-related-artists-artists.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,IAwBlB,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/artists/list-related-artists-artists.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-related-artists-artists.d.ts.map

package/tools/artists/list-related-artists-artists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-related-artists-artists.d.ts","sourceRoot":"","sources":["../../src/tools/artists/list-related-artists-artists.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,IAwBlB,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/artists/list-related-artists-artists.js

@@ -0,0 +1,44 @@
+"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: 'artists',
+    operation: 'read',
+    tags: [],
+    httpMethod: 'get',
+    httpPath: '/artists/{id}/related-artists',
+    operationId: 'get-an-artists-related-artists',
+};
+exports.tool = {
+    name: 'list_related_artists_artists',
+    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 Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history.\n\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/artist_list_related_artists_response',\n  $defs: {\n    artist_list_related_artists_response: {\n      type: 'object',\n      properties: {\n        artists: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/artist_object'\n          }\n        }\n      },\n      required: [        'artists'\n      ]\n    },\n    artist_object: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        },\n        external_urls: {\n          $ref: '#/$defs/external_url_object'\n        },\n        followers: {\n          $ref: '#/$defs/followers_object'\n        },\n        genres: {\n          type: 'array',\n          description: 'A list of the genres the artist is associated with. If not yet classified, the array is empty.\\n',\n          items: {\n            type: 'string'\n          }\n        },\n        href: {\n          type: 'string',\n          description: 'A link to the Web API endpoint providing full details of the artist.\\n'\n        },\n        images: {\n          type: 'array',\n          description: 'Images of the artist in various sizes, widest first.\\n',\n          items: {\n            $ref: '#/$defs/image_object'\n          }\n        },\n        name: {\n          type: 'string',\n          description: 'The name of the artist.\\n'\n        },\n        popularity: {\n          type: 'integer',\n          description: 'The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist\\'s popularity is calculated from the popularity of all the artist\\'s tracks.\\n'\n        },\n        type: {\n          type: 'string',\n          description: 'The object type.',\n          enum: [            'artist'\n          ]\n        },\n        uri: {\n          type: 'string',\n          description: 'The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the artist.\\n'\n        }\n      }\n    },\n    external_url_object: {\n      type: 'object',\n      properties: {\n        spotify: {\n          type: 'string',\n          description: 'The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.\\n'\n        }\n      }\n    },\n    followers_object: {\n      type: 'object',\n      properties: {\n        href: {\n          type: 'string',\n          description: 'This will always be set to null, as the Web API does not support it at the moment.\\n'\n        },\n        total: {\n          type: 'integer',\n          description: 'The total number of followers.\\n'\n        }\n      }\n    },\n    image_object: {\n      type: 'object',\n      properties: {\n        height: {\n          type: 'integer',\n          description: 'The image height in pixels.\\n'\n        },\n        url: {\n          type: 'string',\n          description: 'The source URL of the image.\\n'\n        },\n        width: {\n          type: 'integer',\n          description: 'The image width in pixels.\\n'\n        }\n      },\n      required: [        'height',\n        'url',\n        'width'\n      ]\n    }\n  }\n}\n```",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                title: 'Spotify Artist ID',
+                description: 'The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) of the artist.\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: ['id'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+const handler = async (client, args) => {
+    const { id, jq_filter, ...body } = args;
+    return (0, types_1.asTextContentResult)(await (0, filtering_1.maybeFilter)(jq_filter, await client.artists.listRelatedArtists(id)));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=list-related-artists-artists.js.map

package/tools/artists/list-related-artists-artists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-related-artists-artists.js","sourceRoot":"","sources":["../../src/tools/artists/list-related-artists-artists.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAuD;AACvD,sDAA2E;AAK9D,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,SAAS;IACnB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,+BAA+B;IACzC,WAAW,EAAE,gCAAgC;CAC9C,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,qgHAAqgH;IACvgH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,mBAAmB;gBAC1B,WAAW,EAAE,qFAAqF;aACnG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW;gBAClB,WAAW,EACT,kWAAkW;aACrW;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,IAAyC,EAAE,EAAE;IAC1F,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAC/C,OAAO,IAAA,2BAAmB,EAAC,MAAM,IAAA,uBAAW,EAAC,SAAS,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}