audiobookshelf-mcp 0.1.0

package/dist/tools/items.js

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+import { assertPathSegment, query } from '../api.js';
+import { errorResult, run, untrustedJsonResult } from '../result.js';
+import { detailParam, libraryItemIdParam } from '../schema.js';
+import { compactLibraryItem, compactPodcastEpisode, truncateText, } from '../shape.js';
+export function registerItemReadTools(server, api) {
+    server.registerTool('get_library_item', {
+        title: 'Get library item',
+        description: 'Fetches one book or podcast including its metadata, tags and the ' +
+            'listening progress of the API key’s user. Chapters, audio files and ' +
+            'tracks are not part of the compact projection — use get_item_chapters ' +
+            'for chapters, or detail="full" for everything.',
+        inputSchema: {
+            library_item_id: libraryItemIdParam,
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_item_id, detail }) => run(async () => {
+        const data = await api.get(`/api/items/${assertPathSegment(library_item_id, 'library_item_id')}` +
+            // include=progress is only honoured together with expanded=1.
+            query({ expanded: 1, include: 'progress' }));
+        return untrustedJsonResult(detail === 'full'
+            ? data
+            : compactLibraryItem(data, { includeDescription: true }));
+    }));
+    server.registerTool('get_item_chapters', {
+        title: 'Get item chapters',
+        description: 'Returns the chapter list of a book with start and end times in seconds. ' +
+            'Separate from get_library_item because long audiobooks can have hundreds ' +
+            'of chapters.',
+        inputSchema: {
+            library_item_id: libraryItemIdParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_item_id }) => run(async () => {
+        const safeId = assertPathSegment(library_item_id, 'library_item_id');
+        const item = (await api.get(`/api/items/${safeId}` + query({ expanded: 1 })));
+        const media = (item.media ?? {});
+        const chapters = Array.isArray(media.chapters) ? media.chapters : [];
+        if (item.mediaType !== 'book') {
+            return errorResult(`Library item ${safeId} is a ${String(item.mediaType)}, not a book — ` +
+                'only books have chapters. For podcast episodes use get_podcast_episode.');
+        }
+        return untrustedJsonResult({
+            libraryItemId: safeId,
+            numChapters: chapters.length,
+            chapters,
+        });
+    }));
+    server.registerTool('get_podcast_episode', {
+        title: 'Get podcast episode',
+        description: 'Fetches one podcast episode with its publication date, duration and ' +
+            'description.',
+        inputSchema: {
+            library_item_id: z
+                .string()
+                .min(1)
+                .describe('Library item id of the podcast the episode belongs to'),
+            episode_id: z.string().min(1).describe('Podcast episode id'),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_item_id, episode_id, detail }) => run(async () => {
+        const data = await api.get(`/api/podcasts/${assertPathSegment(library_item_id, 'library_item_id')}` +
+            `/episode/${assertPathSegment(episode_id, 'episode_id')}`);
+        return untrustedJsonResult(detail === 'full'
+            ? data
+            : compactPodcastEpisode(data, { includeDescription: true }));
+    }));
+    server.registerTool('list_recent_episodes', {
+        title: 'List recent podcast episodes',
+        description: 'Lists the most recently published episodes across a podcast library — ' +
+            'the "Newest Episodes" view. Only works on libraries with mediaType ' +
+            '"podcast".',
+        inputSchema: {
+            library_id: z.string().min(1).describe('Id of a podcast library'),
+            page: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('0-based page number, default 0'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe('Episodes per page, default 25, max 100'),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_id, page, limit, detail }) => run(async () => {
+        const data = (await api.get(`/api/libraries/${assertPathSegment(library_id, 'library_id')}/recent-episodes` +
+            query({ limit: limit ?? 25, page: page ?? 0 })));
+        const episodes = Array.isArray(data.episodes) ? data.episodes : [];
+        return untrustedJsonResult({
+            // This endpoint reports no total, only the page it returned.
+            numReturned: episodes.length,
+            limit: data.limit,
+            page: data.page,
+            episodes: detail === 'full'
+                ? episodes
+                : episodes.map((episode) => {
+                    const shaped = compactPodcastEpisode(episode);
+                    const podcast = episode.podcast;
+                    return podcast === undefined
+                        ? shaped
+                        : {
+                            ...shaped,
+                            podcastTitle: truncateText(podcast.metadata?.title, 200),
+                        };
+                }),
+        });
+    }));
+}
+//# sourceMappingURL=items.js.map

package/dist/tools/items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../../src/tools/items.ts"],"names":[],"mappings":"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"}

package/dist/tools/libraries.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type AudiobookshelfApi } from '../api.js';
+export declare function registerLibraryReadTools(server: McpServer, api: AudiobookshelfApi): void;

package/dist/tools/libraries.js

@@ -0,0 +1,337 @@
+import { z } from 'zod';
+import { assertPathSegment, query } from '../api.js';
+import { describeFilterGroups, encodeFilter, FILTER_GROUPS, PROGRESS_FILTER_VALUES, } from '../filters.js';
+import { jsonResult, run, untrustedJsonResult } from '../result.js';
+import { detailParam, libraryIdParam, limitParam, pageParam, } from '../schema.js';
+import { compactAuthor, compactItemPage, compactLibrary, compactLibraryItem, compactSeries, listFrom, } from '../shape.js';
+const DEFAULT_ITEM_LIMIT = 25;
+const DEFAULT_SEARCH_LIMIT = 12;
+/**
+ * Sort keys Audiobookshelf understands. It ignores unknown keys silently and
+ * falls back to the default order, so the useful ones are spelled out for the
+ * model instead of being left to guesswork.
+ */
+const SORT_HINT = 'Sort key in dot notation. Common values: media.metadata.title, ' +
+    'media.metadata.authorName, media.metadata.publishedYear, media.duration, ' +
+    'birthtimeMs, addedAt, size, progress, random.';
+export function registerLibraryReadTools(server, api) {
+    server.registerTool('list_libraries', {
+        title: 'List libraries',
+        description: 'Lists the Audiobookshelf libraries the API key’s user can access, with ' +
+            'their id, name and media type (book or podcast). Start here — every ' +
+            'other library tool needs a library id.',
+        inputSchema: {
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ detail }) => run(async () => {
+        const libraries = listFrom(await api.get('/api/libraries'), 'libraries');
+        return jsonResult({
+            libraries: detail === 'full' ? libraries : libraries.map(compactLibrary),
+        });
+    }));
+    server.registerTool('get_library', {
+        title: 'Get library',
+        description: 'Fetches a single library including its folders and scanner settings.',
+        inputSchema: {
+            library_id: libraryIdParam,
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_id, detail }) => run(async () => {
+        const data = await api.get(`/api/libraries/${assertPathSegment(library_id, 'library_id')}`);
+        const library = data.library ?? data;
+        return jsonResult(detail === 'full' ? library : compactLibrary(library));
+    }));
+    server.registerTool('get_library_stats', {
+        title: 'Get library stats',
+        description: 'Statistics for one library: number of items, authors and genres, total ' +
+            'duration and size, longest and largest items.',
+        inputSchema: {
+            library_id: libraryIdParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_id }) => run(async () => {
+        const data = await api.get(`/api/libraries/${assertPathSegment(library_id, 'library_id')}/stats`);
+        return jsonResult(data);
+    }));
+    server.registerTool('get_library_filter_data', {
+        title: 'Get library filter data',
+        description: 'Returns the values that can be filtered on in this library: authors, ' +
+            'genres, tags, series, narrators, languages and publishers, each with ' +
+            'the id or name to pass to list_library_items as filter_value.',
+        inputSchema: {
+            library_id: libraryIdParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_id }) => run(async () => {
+        const data = await api.get(`/api/libraries/${assertPathSegment(library_id, 'library_id')}/filterdata`);
+        return untrustedJsonResult(data);
+    }));
+    server.registerTool('list_library_items', {
+        title: 'List library items',
+        description: 'Lists items (books or podcasts) of a library, paginated, sortable and ' +
+            'filterable. Use get_library_filter_data first to learn the valid ' +
+            `filter values. Filter groups — ${describeFilterGroups()}.`,
+        inputSchema: {
+            library_id: libraryIdParam,
+            page: pageParam,
+            limit: limitParam(DEFAULT_ITEM_LIMIT),
+            sort: z.string().min(1).optional().describe(SORT_HINT),
+            descending: z
+                .boolean()
+                .optional()
+                .describe('Reverse the sort order, default false'),
+            filter_group: z
+                .enum(FILTER_GROUPS)
+                .optional()
+                .describe('Filter group. The server encodes group and value into the ' +
+                'base64 form its API expects.'),
+            filter_value: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Value for filter_group: an id for authors/series, a name for ' +
+                'genres/tags/narrators/languages/publishers, one of ' +
+                `${PROGRESS_FILTER_VALUES.join('/')} for progress. Must be omitted ` +
+                'for the standalone groups.'),
+            collapse_series: z
+                .boolean()
+                .optional()
+                .describe('Collapse books of the same series into one entry'),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_id, page, limit, sort, descending, filter_group, filter_value, collapse_series, detail, }) => run(async () => {
+        const effectiveLimit = limit ?? DEFAULT_ITEM_LIMIT;
+        const filter = filter_group === undefined
+            ? undefined
+            : encodeFilter(filter_group, filter_value);
+        const data = await api.get(`/api/libraries/${assertPathSegment(library_id, 'library_id')}/items` +
+            query({
+                limit: effectiveLimit,
+                page: page ?? 0,
+                sort,
+                desc: descending === true ? 1 : undefined,
+                filter,
+                // Minified items skip audio files and tracks server-side, which is
+                // both faster and much smaller than shaping the full objects here.
+                minified: 1,
+                collapseseries: collapse_series === true ? 1 : undefined,
+            }));
+        const shaped = compactItemPage(data, detail ?? 'compact');
+        const total = typeof shaped.total === 'number' ? shaped.total : 0;
+        const currentPage = page ?? 0;
+        const seen = (currentPage + 1) * effectiveLimit;
+        return untrustedJsonResult({
+            ...shaped,
+            ...(total > seen
+                ? {
+                    note: `${total} items match — call list_library_items with page=${currentPage + 1} for the next ${effectiveLimit}.`,
+                }
+                : {}),
+        });
+    }));
+    server.registerTool('search_library', {
+        title: 'Search a library',
+        description: 'Full-text search within one library. Matches books, podcasts, series, ' +
+            'authors, narrators and tags. Use this for "do I own X?" questions; use ' +
+            'list_library_items with a filter for "show me all X" questions.',
+        inputSchema: {
+            library_id: libraryIdParam,
+            q: z.string().min(1).describe('Search query'),
+            limit: limitParam(DEFAULT_SEARCH_LIMIT),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_id, q, limit, detail }) => run(async () => {
+        const data = (await api.get(`/api/libraries/${assertPathSegment(library_id, 'library_id')}/search` +
+            query({ q, limit: limit ?? DEFAULT_SEARCH_LIMIT })));
+        if (detail === 'full')
+            return untrustedJsonResult(data);
+        // The search response groups matches: book/podcast hits are wrapped in
+        // { libraryItem, matchKey, matchText }, the rest are plain entities.
+        const wrapped = (key) => Array.isArray(data[key]) ? data[key] : [];
+        return untrustedJsonResult({
+            book: wrapped('book').map((entry) => {
+                const hit = entry;
+                return {
+                    matchKey: hit.matchKey,
+                    matchText: hit.matchText,
+                    libraryItem: compactLibraryItem(hit.libraryItem),
+                };
+            }),
+            podcast: wrapped('podcast').map((entry) => {
+                const hit = entry;
+                return {
+                    matchKey: hit.matchKey,
+                    matchText: hit.matchText,
+                    libraryItem: compactLibraryItem(hit.libraryItem),
+                };
+            }),
+            series: wrapped('series').map((entry) => {
+                const hit = entry;
+                return compactSeries(hit.series ?? hit);
+            }),
+            authors: wrapped('authors').map((a) => compactAuthor(a)),
+            narrators: wrapped('narrators'),
+            tags: wrapped('tags'),
+        });
+    }));
+    server.registerTool('get_personalized_shelves', {
+        title: 'Get personalized shelves',
+        description: 'The shelves of the Audiobookshelf home screen for this user: Continue ' +
+            'Listening, Continue Series, Recently Added, Newest Episodes, Listen ' +
+            'Again and so on. The fastest answer to "what am I listening to right now?".',
+        inputSchema: {
+            library_id: libraryIdParam,
+            limit: limitParam(10),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_id, limit, detail }) => run(async () => {
+        const data = (await api.get(`/api/libraries/${assertPathSegment(library_id, 'library_id')}/personalized` +
+            query({ limit: limit ?? 10 })));
+        if (detail === 'full')
+            return untrustedJsonResult(data);
+        const shelves = Array.isArray(data) ? data : [];
+        return untrustedJsonResult(shelves.map((entry) => {
+            const shelf = entry;
+            const entities = Array.isArray(shelf.entities)
+                ? shelf.entities
+                : [];
+            return {
+                id: shelf.id,
+                label: shelf.label,
+                type: shelf.type,
+                // Shelves hold library items, episodes, series or authors
+                // depending on `type`; the item projection covers the first two
+                // and passes the rest through unchanged.
+                entities: entities.map((entity) => shelf.type === 'book' || shelf.type === 'podcast'
+                    ? compactLibraryItem(entity)
+                    : entity),
+            };
+        }));
+    }));
+    server.registerTool('list_series', {
+        title: 'List series',
+        description: 'Lists the series of a book library with their number of books and total ' +
+            'duration. To list the books of one series, call list_library_items with ' +
+            'filter_group="series" and filter_value=<series id>.',
+        inputSchema: {
+            library_id: libraryIdParam,
+            page: pageParam,
+            limit: limitParam(DEFAULT_ITEM_LIMIT),
+            sort: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Sort key, e.g. name, numBooks, addedAt, totalDuration'),
+            descending: z.boolean().optional().describe('Reverse the sort order'),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_id, page, limit, sort, descending, detail }) => run(async () => {
+        const data = (await api.get(`/api/libraries/${assertPathSegment(library_id, 'library_id')}/series` +
+            query({
+                limit: limit ?? DEFAULT_ITEM_LIMIT,
+                page: page ?? 0,
+                sort,
+                desc: descending === true ? 1 : undefined,
+                minified: 1,
+            })));
+        const results = listFrom(data, 'series');
+        return untrustedJsonResult({
+            total: data.total,
+            page: data.page,
+            limit: data.limit,
+            // Without includeBooks: the endpoint embeds every book of every series,
+            // which dwarfs the series data itself.
+            results: detail === 'full' ? results : results.map((s) => compactSeries(s)),
+        });
+    }));
+    server.registerTool('get_series', {
+        title: 'Get series',
+        description: 'Fetches a single series by id, including its books. To list the books ' +
+            'with paging and sorting, use list_library_items with ' +
+            'filter_group="series" instead.',
+        inputSchema: {
+            series_id: z.string().min(1).describe('Series id'),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ series_id, detail }) => run(async () => {
+        const data = await api.get(`/api/series/${assertPathSegment(series_id, 'series_id')}`);
+        return untrustedJsonResult(detail === 'full' ? data : compactSeries(data, { includeBooks: true }));
+    }));
+    server.registerTool('list_authors', {
+        title: 'List authors',
+        description: 'Lists all authors of a book library with their number of books. To list ' +
+            'the books of one author, call list_library_items with ' +
+            'filter_group="authors" and filter_value=<author id>.',
+        inputSchema: {
+            library_id: libraryIdParam,
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_id, detail }) => run(async () => {
+        const authors = listFrom(await api.get(`/api/libraries/${assertPathSegment(library_id, 'library_id')}/authors`), 'authors');
+        return untrustedJsonResult({
+            numAuthors: authors.length,
+            authors: detail === 'full' ? authors : authors.map((a) => compactAuthor(a)),
+        });
+    }));
+    server.registerTool('get_author', {
+        title: 'Get author',
+        description: 'Fetches a single author, optionally with the library items attributed ' +
+            'to them.',
+        inputSchema: {
+            author_id: z.string().min(1).describe('Author id'),
+            include_items: z
+                .boolean()
+                .optional()
+                .describe('Also return the author’s library items, default false'),
+            library_id: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Restrict the returned items to this library'),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ author_id, include_items, library_id, detail }) => run(async () => {
+        const data = await api.get(`/api/authors/${assertPathSegment(author_id, 'author_id')}` +
+            query({
+                include: include_items === true ? 'items' : undefined,
+                library: library_id === undefined
+                    ? undefined
+                    : assertPathSegment(library_id, 'library_id'),
+            }));
+        return untrustedJsonResult(detail === 'full'
+            ? data
+            : compactAuthor(data, { includeDescription: true }));
+    }));
+    server.registerTool('list_tags', {
+        title: 'List tags',
+        description: 'Lists all tags used on the server, across libraries. Tags are the ' +
+            'user-defined labels on library items.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => run(async () => untrustedJsonResult(await api.get('/api/tags'))));
+    server.registerTool('list_genres', {
+        title: 'List genres',
+        description: 'Lists all genres used on the server, across libraries. Genres come from ' +
+            'the media metadata, not from the user.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => run(async () => untrustedJsonResult(await api.get('/api/genres'))));
+    server.registerTool('get_server_status', {
+        title: 'Get server status',
+        description: 'Version and initialization state of the Audiobookshelf server. Useful ' +
+            'to check connectivity and whether the server is new enough for API keys ' +
+            '(2.26.0 or later).',
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => run(async () => jsonResult(await api.get('/status'))));
+}
+//# sourceMappingURL=libraries.js.map

package/dist/tools/libraries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libraries.js","sourceRoot":"","sources":["../../src/tools/libraries.ts"],"names":[],"mappings":"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"}

package/dist/tools/me.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type AudiobookshelfApi } from '../api.js';
+export declare function registerMeReadTools(server: McpServer, api: AudiobookshelfApi): void;

package/dist/tools/me.js

@@ -0,0 +1,141 @@
+import { z } from 'zod';
+import { assertPathSegment, query } from '../api.js';
+import { jsonResult, run, untrustedJsonResult } from '../result.js';
+import { detailParam, libraryItemIdParam, limitParam, pageParam, } from '../schema.js';
+import { compactBookmark, compactLibraryItem, compactListeningSession, compactListeningStats, compactMediaProgress, compactUser, listFrom, } from '../shape.js';
+const EPISODE_ID_DESCRIPTION = 'Podcast episode id — required for podcast episodes, omitted for books';
+export function registerMeReadTools(server, api) {
+    server.registerTool('get_me', {
+        title: 'Get the current user',
+        description: 'Returns the Audiobookshelf user the API key acts on behalf of, with ' +
+            'their permissions and accessible libraries. The compact projection ' +
+            'reports media progress and bookmarks as counts — the full user object ' +
+            'embeds every single one of them.',
+        inputSchema: {
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ detail }) => run(async () => {
+        const data = await api.get('/api/me');
+        return jsonResult(detail === 'full' ? data : compactUser(data));
+    }));
+    server.registerTool('list_items_in_progress', {
+        title: 'List items in progress',
+        description: 'The items the user has started but not finished, newest first — the ' +
+            '"Continue Listening" list across all libraries. The entries carry ' +
+            'progressLastUpdate but not the position itself; use get_media_progress ' +
+            'for that. For podcasts, recentEpisode names the episode in progress.',
+        inputSchema: {
+            limit: limitParam(25),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ limit, detail }) => run(async () => {
+        const data = await api.get(`/api/me/items-in-progress${query({ limit: limit ?? 25 })}`);
+        const items = listFrom(data, 'libraryItems');
+        return untrustedJsonResult({
+            numReturned: items.length,
+            libraryItems: detail === 'full' ? items : items.map((i) => compactLibraryItem(i)),
+        });
+    }));
+    server.registerTool('get_media_progress', {
+        title: 'Get media progress',
+        description: 'The listening progress of the current user for one book or podcast ' +
+            'episode: position, percentage and whether it is finished. Returns a 404 ' +
+            'error when the item has never been started.',
+        inputSchema: {
+            library_item_id: libraryItemIdParam,
+            episode_id: z
+                .string()
+                .min(1)
+                .optional()
+                .describe(EPISODE_ID_DESCRIPTION),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_item_id, episode_id, detail }) => run(async () => {
+        const path = `/api/me/progress/${assertPathSegment(library_item_id, 'library_item_id')}` +
+            (episode_id === undefined
+                ? ''
+                : `/${assertPathSegment(episode_id, 'episode_id')}`);
+        const data = await api.get(path);
+        return jsonResult(detail === 'full' ? data : compactMediaProgress(data));
+    }));
+    server.registerTool('get_listening_stats', {
+        title: 'Get listening stats',
+        description: 'Aggregated listening statistics of the current user: total time, time ' +
+            'per weekday, the last 30 days, the ten most listened items and the ten ' +
+            'most recent sessions. detail="full" returns the complete per-day history ' +
+            'and the full metadata of every item ever listened to, which is the ' +
+            'largest response this API produces.',
+        inputSchema: {
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ detail }) => run(async () => {
+        const data = await api.get('/api/me/listening-stats');
+        return untrustedJsonResult(detail === 'full' ? data : compactListeningStats(data));
+    }));
+    server.registerTool('get_year_stats', {
+        title: 'Get stats for a year',
+        description: 'The "year in review" statistics of the current user for one calendar ' +
+            'year: books finished, time listened, top authors and genres.',
+        inputSchema: {
+            year: z
+                .number()
+                .int()
+                .min(2000)
+                .max(2100)
+                .describe('Calendar year, e.g. 2026'),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ year }) => run(async () => untrustedJsonResult(await api.get(`/api/me/stats/year/${year}`))));
+    server.registerTool('list_listening_sessions', {
+        title: 'List listening sessions',
+        description: 'The playback sessions of the current user, newest first — each entry is ' +
+            'one listening stretch with device, position and time listened.',
+        inputSchema: {
+            page: pageParam,
+            limit: limitParam(10),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ page, limit, detail }) => run(async () => {
+        const data = (await api.get('/api/me/listening-sessions' +
+            query({ page: page ?? 0, itemsPerPage: limit ?? 10 })));
+        const sessions = listFrom(data, 'sessions');
+        return untrustedJsonResult({
+            total: data.total,
+            numPages: data.numPages,
+            page: data.page,
+            sessions: detail === 'full'
+                ? sessions
+                : sessions.map(compactListeningSession),
+        });
+    }));
+    server.registerTool('list_bookmarks', {
+        title: 'List bookmarks',
+        description: 'The bookmarks of the current user — either all of them, or those of one ' +
+            'library item. A bookmark is a named position in seconds.',
+        inputSchema: {
+            library_item_id: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Restrict the result to the bookmarks of this library item'),
+            detail: detailParam,
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ library_item_id, detail }) => run(async () => {
+        const path = library_item_id === undefined
+            ? '/api/me/bookmarks'
+            : `/api/me/bookmarks/${assertPathSegment(library_item_id, 'library_item_id')}`;
+        const data = await api.get(path);
+        const bookmarks = listFrom(data, 'bookmarks');
+        return untrustedJsonResult({
+            numBookmarks: bookmarks.length,
+            bookmarks: detail === 'full' ? bookmarks : bookmarks.map(compactBookmark),
+        });
+    }));
+}
+//# sourceMappingURL=me.js.map

package/dist/tools/me.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"me.js","sourceRoot":"","sources":["../../src/tools/me.ts"],"names":[],"mappings":"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"}