@cyanheads/musicbrainz-mcp-server 0.1.9 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/AGENTS.md +33 -15
  2. package/CLAUDE.md +33 -15
  3. package/Dockerfile +3 -3
  4. package/README.md +40 -21
  5. package/changelog/0.2.x/0.2.0.md +28 -0
  6. package/changelog/0.2.x/0.2.1.md +32 -0
  7. package/dist/config/server-config.d.ts +1 -0
  8. package/dist/config/server-config.d.ts.map +1 -1
  9. package/dist/config/server-config.js +5 -0
  10. package/dist/config/server-config.js.map +1 -1
  11. package/dist/index.js +1 -1
  12. package/dist/index.js.map +1 -1
  13. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -1
  14. package/dist/mcp-server/resources/definitions/entity.resource.js +14 -4
  15. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
  16. package/dist/mcp-server/tools/definitions/_pagination.d.ts +12 -0
  17. package/dist/mcp-server/tools/definitions/_pagination.d.ts.map +1 -0
  18. package/dist/mcp-server/tools/definitions/_pagination.js +46 -0
  19. package/dist/mcp-server/tools/definitions/_pagination.js.map +1 -0
  20. package/dist/mcp-server/tools/definitions/_shared.d.ts +10 -4
  21. package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -1
  22. package/dist/mcp-server/tools/definitions/_shared.js +44 -27
  23. package/dist/mcp-server/tools/definitions/_shared.js.map +1 -1
  24. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +10 -7
  25. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
  26. package/dist/mcp-server/tools/definitions/browse-entities.tool.js +83 -50
  27. package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
  28. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +5 -3
  29. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -1
  30. package/dist/mcp-server/tools/definitions/get-artist.tool.js +6 -6
  31. package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -1
  32. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +12 -5
  33. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -1
  34. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +66 -24
  35. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -1
  36. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +1 -1
  37. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -1
  38. package/dist/mcp-server/tools/definitions/get-label.tool.js +3 -3
  39. package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -1
  40. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +14 -1
  41. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -1
  42. package/dist/mcp-server/tools/definitions/get-recording.tool.js +26 -5
  43. package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -1
  44. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +1 -1
  45. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -1
  46. package/dist/mcp-server/tools/definitions/get-release-group.tool.js +3 -3
  47. package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -1
  48. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +14 -4
  49. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -1
  50. package/dist/mcp-server/tools/definitions/get-release.tool.js +50 -8
  51. package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
  52. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +12 -4
  53. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -1
  54. package/dist/mcp-server/tools/definitions/get-work.tool.js +33 -10
  55. package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
  56. package/dist/mcp-server/tools/definitions/index.d.ts +62 -16
  57. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  58. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +2 -2
  59. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -1
  60. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +26 -7
  61. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -1
  62. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +3 -1
  63. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -1
  64. package/dist/mcp-server/tools/definitions/search-entities.tool.js +23 -18
  65. package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
  66. package/dist/services/cover-art/cover-art-service.d.ts +2 -2
  67. package/dist/services/cover-art/cover-art-service.d.ts.map +1 -1
  68. package/dist/services/cover-art/cover-art-service.js +6 -7
  69. package/dist/services/cover-art/cover-art-service.js.map +1 -1
  70. package/dist/services/musicbrainz/mbid.d.ts +5 -0
  71. package/dist/services/musicbrainz/mbid.d.ts.map +1 -0
  72. package/dist/services/musicbrainz/mbid.js +17 -0
  73. package/dist/services/musicbrainz/mbid.js.map +1 -0
  74. package/dist/services/musicbrainz/musicbrainz-service.d.ts +8 -3
  75. package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
  76. package/dist/services/musicbrainz/musicbrainz-service.js +27 -8
  77. package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
  78. package/dist/services/musicbrainz/release-appearances.d.ts +16 -0
  79. package/dist/services/musicbrainz/release-appearances.d.ts.map +1 -0
  80. package/dist/services/musicbrainz/release-appearances.js +15 -0
  81. package/dist/services/musicbrainz/release-appearances.js.map +1 -0
  82. package/dist/services/musicbrainz/types.d.ts +7 -4
  83. package/dist/services/musicbrainz/types.d.ts.map +1 -1
  84. package/dist/services/musicbrainz/work-relations.d.ts +19 -0
  85. package/dist/services/musicbrainz/work-relations.d.ts.map +1 -0
  86. package/dist/services/musicbrainz/work-relations.js +26 -0
  87. package/dist/services/musicbrainz/work-relations.js.map +1 -0
  88. package/package.json +8 -8
  89. package/server.json +17 -3
@@ -1,24 +1,24 @@
1
1
  /**
2
2
  * @fileoverview musicbrainz_browse_entities — paginate the COMPLETE set of
3
3
  * entities linked to a parent MBID: every release on a label, every release-group
4
- * by an artist, every recording of a work, every release in a release-group. The
5
- * only complete-enumeration path — the get_* tools' embedded lists are capped at
6
- * one page (25), so this is a correctness tool, not a convenience.
4
+ * by an artist, every recording of a work or release, every release in a group.
5
+ * Enumerates entities rather than ordered tracks or performance relationship details.
7
6
  * @module mcp-server/tools/definitions/browse-entities.tool
8
7
  */
9
8
  import { tool, z } from '@cyanheads/mcp-ts-core';
10
- import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
9
+ import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
10
+ import { normalizeMbid } from '../../../services/musicbrainz/mbid.js';
11
11
  import { getMusicBrainzService, MusicBrainzService, } from '../../../services/musicbrainz/musicbrainz-service.js';
12
- import { artistCreditString, classifyMbidError, formatDuration, normalizeArtistCredits, safeText, } from './_shared.js';
12
+ import { applyPageLimit, PageLimit, pageNotice } from './_pagination.js';
13
+ import { artistCreditString, classifyMbidError, formatDuration, MbidInput, normalizeArtistCredits, safeText, } from './_shared.js';
13
14
  const TARGET_TYPES = ['artist', 'release-group', 'release', 'recording', 'work', 'label'];
14
- /** Maps the `{type}-count` envelope key for each entity type. */
15
- const COUNT_KEY = {
16
- artist: 'artist-count',
17
- 'release-group': 'release-group-count',
18
- release: 'release-count',
19
- recording: 'recording-count',
20
- work: 'work-count',
21
- label: 'label-count',
15
+ const PARENTS = {
16
+ artist: ['area', 'recording', 'release', 'release-group', 'work'],
17
+ label: ['area', 'release'],
18
+ 'release-group': ['artist', 'release'],
19
+ release: ['area', 'artist', 'label', 'recording', 'release-group'],
20
+ recording: ['artist', 'release', 'work'],
21
+ work: ['artist'],
22
22
  };
23
23
  const EntityRefSchema = z
24
24
  .object({
@@ -28,6 +28,10 @@ const EntityRefSchema = z
28
28
  .describe('Entity name (artist/label) or title (release-group/release/recording/work).'),
29
29
  disambiguation: z.string().optional().describe('Short qualifier. Omitted when absent.'),
30
30
  type: z.string().optional().describe('Entity subtype, where applicable. Omitted when absent.'),
31
+ status: z
32
+ .string()
33
+ .optional()
34
+ .describe('Release status (e.g. Official or Bootleg). Omitted for other entity types or when absent.'),
31
35
  artistCredit: z
32
36
  .string()
33
37
  .optional()
@@ -75,13 +79,13 @@ function mapEntity(type, raw) {
75
79
  const date = isReleaseGroup
76
80
  ? e['first-release-date']
77
81
  : e.date;
78
- const subtype = isReleaseGroup
79
- ? e['primary-type']
80
- : e.status;
82
+ const subtype = isReleaseGroup ? e['primary-type'] : undefined;
83
+ const status = !isReleaseGroup ? e.status : undefined;
81
84
  return {
82
85
  ...common,
83
86
  name: e.title ?? '',
84
87
  ...(subtype ? { type: subtype } : {}),
88
+ ...(status ? { status } : {}),
85
89
  artistCredit: artistCreditString(normalizeArtistCredits(e['artist-credit'])),
86
90
  ...(date ? { date } : {}),
87
91
  ...(e.country ? { country: e.country } : {}),
@@ -89,14 +93,14 @@ function mapEntity(type, raw) {
89
93
  }
90
94
  export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
91
95
  title: 'musicbrainz-mcp-server: browse entities',
92
- description: 'Paginate the COMPLETE set of entities linked to a parent MBID — every release-group by an artist, every release on a label, every recording of a work, every release in a release-group. This is the only complete-enumeration path: the get_* tools embed at most one page (25) of any linked list, so use this tool whenever a linked set may exceed a page (a prolific artist, a major label with thousands of releases, a heavily-covered work). Provide exactly ONE link MBID matching a valid parent→child relationship for the target_type. Pages arbitrarily deep via offset; totalCount is the true upstream total.',
96
+ description: 'Paginate entities linked to one parent MBID. Accepted parents by target: artist → area, recording, release, release-group, work; label → area, release; release-group → artist, release; release → area, artist, label, recording, release-group; recording → artist, release, work; work → artist. Artist release-groups and release-group editions embed one upstream page in get_* lookups; use this tool for the complete entity set. Recording browse returns identities, not performance attributes/dates or ordered release tracks: use musicbrainz_get_recording for work relationships and musicbrainz_get_release for tracks. Provide exactly one valid parent link. offset pages to any depth; totalCount is the upstream entity total. Release rows carry status, other entity subtypes use type.',
93
97
  annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
94
98
  errors: [
95
99
  {
96
100
  reason: 'invalid_link',
97
101
  code: JsonRpcErrorCode.ValidationError,
98
- when: 'No link MBID was provided, more than one was provided, or the link MBID is malformed (HTTP 400).',
99
- recovery: 'Provide exactly one link MBID (e.g. link.artist) that is a valid parent for the target_type. MBIDs are 36-char UUIDs.',
102
+ when: 'A parent key is unknown, aliases collide, not exactly one nonempty parent is supplied, or the MBID/parent combination is invalid.',
103
+ recovery: 'Provide exactly one parent key with a nonzero hexadecimal UUID MBID. Accepted parents by target: artist → area, recording, release, release-group, work; label → area, release; release-group → artist, release; release → area, artist, label, recording, release-group; recording → artist, release, work; work → artist. releaseGroup and release_group alias release-group; never combine aliases.',
100
104
  },
101
105
  {
102
106
  reason: 'entity_not_found',
@@ -109,24 +113,19 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
109
113
  target_type: z.enum(TARGET_TYPES).describe('The entity type to enumerate (the children).'),
110
114
  link: z
111
115
  .object({
112
- artist: z
113
- .string()
114
- .optional()
115
- .describe('Parent artist MBID (e.g. release-groups/recordings/releases by this artist).'),
116
- label: z.string().optional().describe('Parent label MBID (releases on this label).'),
117
- 'release-group': z
118
- .string()
119
- .optional()
120
- .describe('Parent release-group MBID (releases in this group).'),
121
- recording: z
122
- .string()
123
- .optional()
124
- .describe('Parent recording MBID (releases containing this recording).'),
125
- work: z.string().optional().describe('Parent work MBID (recordings of this work).'),
126
- area: z.string().optional().describe('Parent area MBID (artists/labels in this area).'),
116
+ artist: MbidInput.optional().describe('Parent artist MBID (e.g. release-groups/recordings/releases by this artist).'),
117
+ label: MbidInput.optional().describe('Parent label MBID (releases on this label).'),
118
+ 'release-group': MbidInput.optional().describe('Parent release-group MBID (releases in this group).'),
119
+ release: MbidInput.optional().describe('Parent release MBID (artists, labels, release-groups, or recording entities in this edition; recordings are not ordered tracks).'),
120
+ releaseGroup: MbidInput.optional().describe('Alias for release-group; use only one spelling.'),
121
+ release_group: MbidInput.optional().describe('Alias for release-group; use only one spelling.'),
122
+ recording: MbidInput.optional().describe('Parent recording MBID (artists or releases linked to this recording).'),
123
+ work: MbidInput.optional().describe('Parent work MBID (artists or recordings linked to this work).'),
124
+ area: MbidInput.optional().describe('Parent area MBID (artists, labels, or releases in this area).'),
127
125
  })
126
+ .catchall(z.unknown())
128
127
  .describe('Exactly one parent MBID. The valid key depends on target_type (see the description).'),
129
- limit: z.number().int().min(1).max(100).default(25).describe('Page size (1–100).'),
128
+ limit: PageLimit,
130
129
  offset: z
131
130
  .number()
132
131
  .int()
@@ -138,7 +137,7 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
138
137
  targetType: z.string().describe('The entity type that was enumerated.'),
139
138
  linkType: z
140
139
  .string()
141
- .describe('The parent link type used (artist, label, release-group, recording, work, or area).'),
140
+ .describe('The parent link type used (artist, label, release-group, release, recording, work, or area).'),
142
141
  linkMbid: z.string().describe('The parent MBID that was browsed.'),
143
142
  entities: z.array(EntityRefSchema).describe('This page of linked entities, in upstream order.'),
144
143
  offset: z.number().describe('The offset used for this page.'),
@@ -167,20 +166,56 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
167
166
  async handler(input, ctx) {
168
167
  ctx.log.info('musicbrainz_browse_entities', { target: input.target_type });
169
168
  const service = getMusicBrainzService();
170
- const linkEntries = Object.entries(input.link).filter(([, v]) => typeof v === 'string' && v.length > 0);
169
+ const acceptedKeys = [
170
+ 'artist',
171
+ 'label',
172
+ 'release-group',
173
+ 'release',
174
+ 'recording',
175
+ 'work',
176
+ 'area',
177
+ ];
178
+ const aliases = ['releaseGroup', 'release_group'];
179
+ const unknownKeys = Object.keys(input.link).filter((key) => !acceptedKeys.includes(key) && !aliases.includes(key));
180
+ if (unknownKeys.length) {
181
+ throw ctx.fail('invalid_link', `Unknown link key(s): ${unknownKeys.join(', ')}. Accepted keys: ${acceptedKeys.join(', ')}.`);
182
+ }
183
+ const groupKeys = ['release-group', ...aliases].filter((key) => Object.hasOwn(input.link, key));
184
+ if (groupKeys.length > 1) {
185
+ throw ctx.fail('invalid_link', `release-group alias collision: ${groupKeys.join(', ')}. Supply only one spelling.`);
186
+ }
187
+ const normalizedLink = Object.fromEntries(Object.entries(input.link).map(([key, value]) => [
188
+ aliases.includes(key) ? 'release-group' : key,
189
+ value,
190
+ ]));
191
+ const linkEntries = Object.entries(normalizedLink).filter(([, v]) => typeof v === 'string' && v.length > 0);
171
192
  const first = linkEntries[0];
172
193
  if (linkEntries.length !== 1 || !first) {
173
194
  throw ctx.fail('invalid_link', `Provide exactly one link MBID — received ${linkEntries.length}.`);
174
195
  }
175
- const [linkType, linkMbid] = first;
196
+ const [linkType, suppliedMbid] = first;
197
+ if (!PARENTS[input.target_type].includes(linkType)) {
198
+ throw ctx.fail('invalid_link', `Unsupported browse pair: ${input.target_type} by ${linkType}. Accepted parents for ${input.target_type}: ${PARENTS[input.target_type].join(', ')}.`);
199
+ }
200
+ let linkMbid;
201
+ try {
202
+ linkMbid = normalizeMbid(suppliedMbid);
203
+ }
204
+ catch (error) {
205
+ if (classifyMbidError(error) === 'invalid_mbid') {
206
+ throw ctx.fail('invalid_link', 'Malformed link MBID: supply a nonzero hyphenated hexadecimal UUID.');
207
+ }
208
+ throw error;
209
+ }
176
210
  let envelope;
211
+ const limit = applyPageLimit(input.limit, 'musicbrainz_browse_entities', ctx);
177
212
  try {
178
- envelope = await service.browse(input.target_type, { link: linkType, linkMbid, limit: input.limit, offset: input.offset }, ctx, { signal: ctx.signal });
213
+ envelope = await service.browse(input.target_type, { link: linkType, linkMbid, limit, offset: input.offset }, ctx, { signal: ctx.signal });
179
214
  }
180
215
  catch (error) {
181
216
  const reason = classifyMbidError(error);
182
- if (reason === 'invalid_mbid') {
183
- throw ctx.fail('invalid_link', `Malformed link MBID "${linkMbid}".`);
217
+ if (error instanceof McpError && error.code === JsonRpcErrorCode.ValidationError) {
218
+ throw ctx.fail('invalid_link', `MusicBrainz rejected the browse query ${input.target_type} by ${linkType}; verify the parent type and MBID.`);
184
219
  }
185
220
  if (reason === 'entity_not_found') {
186
221
  throw ctx.fail('entity_not_found', `No ${linkType} exists with MBID ${linkMbid}.`);
@@ -190,17 +225,14 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
190
225
  const key = MusicBrainzService.pluralKey(input.target_type);
191
226
  const rawEntities = (envelope[key] ?? []);
192
227
  const entities = rawEntities.map((e) => mapEntity(input.target_type, e));
193
- const totalCount = envelope[COUNT_KEY[input.target_type]];
194
- const total = typeof totalCount === 'number' ? totalCount : input.offset + entities.length;
228
+ const total = envelope[`${input.target_type}-count`];
195
229
  ctx.enrich.total(total);
196
230
  const remaining = total - (input.offset + entities.length);
197
- if (remaining > 0) {
198
- ctx.enrich.truncated({ shown: entities.length, cap: input.limit });
199
- ctx.enrich.notice(`${remaining} more linked entit${remaining === 1 ? 'y' : 'ies'} remain. Call again with offset=${input.offset + entities.length} to continue paging.`);
200
- }
201
- else if (entities.length === 0) {
202
- ctx.enrich.notice(`No ${input.target_type} entities are linked to ${linkType} ${linkMbid}.`);
203
- }
231
+ if (remaining > 0)
232
+ ctx.enrich.truncated({ shown: entities.length, cap: limit });
233
+ const notice = pageNotice(total, input.offset, entities.length, input.limit, limit, `No ${input.target_type} entities are linked to ${linkType} ${linkMbid}.`);
234
+ if (notice)
235
+ ctx.enrich.notice(notice);
204
236
  return {
205
237
  targetType: input.target_type,
206
238
  linkType,
@@ -217,6 +249,7 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
217
249
  for (const e of result.entities) {
218
250
  const meta = [
219
251
  e.type ? safeText(e.type) : null,
252
+ e.status ? safeText(e.status) : null,
220
253
  e.artistCredit ? safeText(e.artistCredit) : null,
221
254
  e.date,
222
255
  e.country,
@@ -1 +1 @@
1
- {"version":3,"file":"browse-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/browse-entities.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"browse-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/browse-entities.tool.ts"],"names":[],"mappings":"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"}
@@ -2,8 +2,8 @@
2
2
  * @fileoverview musicbrainz_get_artist — artist profile by MBID: type, country,
3
3
  * life span, gender, area, aliases, tags/genres, plus discography (release-groups)
4
4
  * and band-membership / collaboration relationships and external links. The 80%
5
- * artist-detail call. Discography and relationships are capped at one page by the
6
- * lookup endpoint — musicbrainz_browse_entities enumerates the full set.
5
+ * artist-detail call. Release-groups embed one upstream page; relationships do
6
+ * not. musicbrainz_browse_entities enumerates the full release-group set.
7
7
  * @module mcp-server/tools/definitions/get-artist.tool
8
8
  */
9
9
  import { z } from '@cyanheads/mcp-ts-core';
@@ -52,6 +52,8 @@ export declare const getArtistTool: import("@cyanheads/mcp-ts-core").ToolDefinit
52
52
  targetType: z.ZodString;
53
53
  targetId: z.ZodOptional<z.ZodString>;
54
54
  targetName: z.ZodOptional<z.ZodString>;
55
+ targetDisambiguation: z.ZodOptional<z.ZodString>;
56
+ orderingKey: z.ZodOptional<z.ZodNumber>;
55
57
  begin: z.ZodOptional<z.ZodString>;
56
58
  end: z.ZodOptional<z.ZodString>;
57
59
  }, z.core.$strip>>;
@@ -62,7 +64,7 @@ export declare const getArtistTool: import("@cyanheads/mcp-ts-core").ToolDefinit
62
64
  }, z.core.$strip>, readonly [{
63
65
  readonly reason: "invalid_mbid";
64
66
  readonly code: JsonRpcErrorCode.ValidationError;
65
- readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).";
67
+ readonly when: "The MBID is malformed or the all-zeros sentinel (rejected before fetch), or MusicBrainz rejects it with HTTP 400.";
66
68
  readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities to find an artist's MBID from its name.";
67
69
  }, {
68
70
  readonly reason: "entity_not_found";
@@ -1 +1 @@
1
- {"version":3,"file":"get-artist.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-artist.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA2CjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0LxB,CAAC"}
1
+ {"version":3,"file":"get-artist.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-artist.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA4CjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4LxB,CAAC"}
@@ -2,14 +2,14 @@
2
2
  * @fileoverview musicbrainz_get_artist — artist profile by MBID: type, country,
3
3
  * life span, gender, area, aliases, tags/genres, plus discography (release-groups)
4
4
  * and band-membership / collaboration relationships and external links. The 80%
5
- * artist-detail call. Discography and relationships are capped at one page by the
6
- * lookup endpoint — musicbrainz_browse_entities enumerates the full set.
5
+ * artist-detail call. Release-groups embed one upstream page; relationships do
6
+ * not. musicbrainz_browse_entities enumerates the full release-group set.
7
7
  * @module mcp-server/tools/definitions/get-artist.tool
8
8
  */
9
9
  import { tool, z } from '@cyanheads/mcp-ts-core';
10
10
  import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
11
11
  import { getMusicBrainzService } from '../../../services/musicbrainz/musicbrainz-service.js';
12
- import { AliasSchema, classifyMbidError, ExternalLinkSchema, LifeSpanSchema, MBID_EXAMPLE, normalizeAliases, normalizeLifeSpan, normalizeRelations, normalizeTags, RelationSchema, renderAliases, renderExternalLinks, renderLifeSpan, renderRelationships, renderTags, safeText, TagSchema, } from './_shared.js';
12
+ import { AliasSchema, classifyMbidError, ExternalLinkSchema, LifeSpanSchema, MBID_EXAMPLE, MbidInput, normalizeAliases, normalizeLifeSpan, normalizeRelations, normalizeTags, RelationSchema, renderAliases, renderExternalLinks, renderLifeSpan, renderRelationships, renderTags, safeText, TagSchema, } from './_shared.js';
13
13
  /** One page cap for lookup `inc` embedded lists (25 default / 100 max, no deep offset). */
14
14
  const LOOKUP_PAGE_CAP = 25;
15
15
  const ReleaseGroupRefSchema = z
@@ -30,13 +30,13 @@ const ReleaseGroupRefSchema = z
30
30
  .describe('A release-group in the artist discography (capped to one page — use browse for all).');
31
31
  export const getArtistTool = tool('musicbrainz_get_artist', {
32
32
  title: 'musicbrainz-mcp-server: get artist',
33
- description: "Artist profile by MBID: type (person/group/…), country, life span, gender, area, aliases, tags/genres, plus the discography (release-groups) and band-membership / collaboration relationships and external links (Wikidata QID, Discogs, official site — surfaced as url-rels chainable to those servers). The 80% artist-detail call. Discography and relationships are capped at one page (25); for a prolific artist's complete release-group list, call musicbrainz_browse_entities with target_type=release-group and the artist link.",
33
+ description: 'Artist profile by MBID: type, country, life span, gender, area, aliases, tags/genres, release-groups, band-membership / collaboration relationships, and external links. Release-groups embed one upstream page (25); relationships are not capped. For the complete release-group list, call musicbrainz_browse_entities with target_type=release-group and link.artist.',
34
34
  annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
35
35
  errors: [
36
36
  {
37
37
  reason: 'invalid_mbid',
38
38
  code: JsonRpcErrorCode.ValidationError,
39
- when: 'The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).',
39
+ when: 'The MBID is malformed or the all-zeros sentinel (rejected before fetch), or MusicBrainz rejects it with HTTP 400.',
40
40
  recovery: `MBID must be a 36-character UUID (e.g. ${MBID_EXAMPLE}). Use musicbrainz_search_entities to find an artist's MBID from its name.`,
41
41
  },
42
42
  {
@@ -47,7 +47,7 @@ export const getArtistTool = tool('musicbrainz_get_artist', {
47
47
  },
48
48
  ],
49
49
  input: z.object({
50
- mbid: z.string().describe('Artist MBID (36-character UUID).'),
50
+ mbid: MbidInput.describe('Artist MBID (hyphenated hexadecimal UUID; surrounding whitespace and uppercase accepted).'),
51
51
  inc_release_groups: z
52
52
  .boolean()
53
53
  .default(true)
@@ -1 +1 @@
1
- {"version":3,"file":"get-artist.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-artist.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"get-artist.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-artist.tool.ts"],"names":[],"mappings":"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"}
@@ -2,10 +2,10 @@
2
2
  * @fileoverview musicbrainz_get_cover_art — Cover Art Archive images for a release
3
3
  * or release-group MBID: front/back flags, image types, full-resolution URLs, and
4
4
  * 250/500/1200px thumbnails. Returns an empty image set (not an error) when the
5
- * entity has no art. The archive answers HTTP 404 alike for a real entity with no
6
- * art, the all-zeros MBID, and an MBID matching no entity, so on a 404 the handler
7
- * checks the MBID with a bounded MusicBrainz lookup of the same entity type
8
- * before reporting "no art". Separate from musicbrainz_get_release so art is
5
+ * entity has no art. Malformed/all-zero MBIDs fail before fetch. For a well-shaped
6
+ * MBID an archive 404 means no art or no entity, so the handler checks it with a
7
+ * bounded MusicBrainz lookup of the same entity type before reporting "no art".
8
+ * Separate from musicbrainz_get_release so art is
9
9
  * fetchable without the full record.
10
10
  * @module mcp-server/tools/definitions/get-cover-art.tool
11
11
  */
@@ -17,9 +17,12 @@ export declare const getCoverArtTool: import("@cyanheads/mcp-ts-core").ToolDefin
17
17
  release: "release";
18
18
  "release-group": "release-group";
19
19
  }>>;
20
+ limit: z.ZodDefault<z.ZodNumber>;
21
+ offset: z.ZodDefault<z.ZodNumber>;
20
22
  }, z.core.$strip>, z.ZodObject<{
21
23
  mbid: z.ZodString;
22
24
  entityType: z.ZodString;
25
+ offset: z.ZodNumber;
23
26
  representativeRelease: z.ZodOptional<z.ZodString>;
24
27
  images: z.ZodArray<z.ZodObject<{
25
28
  id: z.ZodString;
@@ -36,7 +39,7 @@ export declare const getCoverArtTool: import("@cyanheads/mcp-ts-core").ToolDefin
36
39
  }, z.core.$strip>, readonly [{
37
40
  readonly reason: "invalid_mbid";
38
41
  readonly code: JsonRpcErrorCode.ValidationError;
39
- readonly when: "The MBID is malformed or the all-zeros sentinel — a value MusicBrainz rejects outright (HTTP 400).";
42
+ readonly when: "The MBID is malformed or the all-zeros sentinel (rejected before fetch), or an upstream rejects it with HTTP 400.";
40
43
  readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities to find a release or release-group MBID.";
41
44
  }, {
42
45
  readonly reason: "entity_not_found";
@@ -45,6 +48,10 @@ export declare const getCoverArtTool: import("@cyanheads/mcp-ts-core").ToolDefin
45
48
  readonly recovery: "No release or release-group exists with that MBID. Check that entity_type matches the MBID (a release-group MBID needs entity_type=release-group), or find the MBID with musicbrainz_search_entities.";
46
49
  }], {
47
50
  readonly hasArt: z.ZodBoolean;
51
+ readonly totalCount: z.ZodNumber;
52
+ readonly truncated: z.ZodOptional<z.ZodBoolean>;
53
+ readonly shown: z.ZodOptional<z.ZodNumber>;
54
+ readonly cap: z.ZodOptional<z.ZodNumber>;
48
55
  readonly notice: z.ZodOptional<z.ZodString>;
49
56
  }>;
50
57
  //# sourceMappingURL=get-cover-art.tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"get-cover-art.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-cover-art.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAwC3E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoK1B,CAAC"}
1
+ {"version":3,"file":"get-cover-art.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-cover-art.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAwC3E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqN1B,CAAC"}