@withpica/mcp-server 2.7.0 → 2.8.0

package/dist/tools/recovery-hints.js

@@ -0,0 +1,277 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+export const RECOVERY_HINTS = {
+    // ── destructive tools ──
+    pica_works_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "search for the work by title",
+            next_tool: "pica_works_query",
+        },
+        {
+            error_code: "HAS_DEPENDENCIES",
+            suggestion: "check what's linked to this work first",
+            next_tool: "pica_works_inspect",
+        },
+    ],
+    pica_works_bulk_delete: [
+        {
+            error_code: "PARTIAL_NOT_FOUND",
+            suggestion: "some IDs not found — list your works to verify",
+            next_tool: "pica_works_query",
+        },
+    ],
+    pica_people_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "search for the person by name",
+            next_tool: "pica_people_query",
+        },
+        {
+            error_code: "PERSON_HAS_CREDITS",
+            suggestion: "check their credits before removing",
+            next_tool: "pica_people_inspect",
+        },
+    ],
+    pica_recordings_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list recordings for this work",
+            next_tool: "pica_recordings_query",
+        },
+    ],
+    pica_agreements_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list your agreements to find the right one",
+            next_tool: "pica_agreements_query",
+        },
+        {
+            error_code: "HAS_LINKED_WORKS",
+            suggestion: "check what works are linked",
+            next_tool: "pica_agreements_inspect",
+        },
+    ],
+    pica_projects_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list your projects",
+            next_tool: "pica_projects_list",
+        },
+    ],
+    pica_merge_duplicates: [
+        {
+            error_code: "ENTITY_NOT_FOUND",
+            suggestion: "check both entities exist",
+            next_tool: "pica_find_duplicates",
+        },
+        {
+            error_code: "MERGE_CONFLICT",
+            suggestion: "compare the entities first",
+            next_tool: "pica_enrichment_compare",
+        },
+    ],
+    pica_team_remove: [
+        {
+            error_code: "CANNOT_REMOVE_OWNER",
+            suggestion: "check team roles",
+            next_tool: "pica_team_list",
+        },
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list team members",
+            next_tool: "pica_team_list",
+        },
+    ],
+    pica_notes_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list your notes",
+            next_tool: "pica_notes_list",
+        },
+    ],
+    pica_memory_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list your memories",
+            next_tool: "pica_memory_list",
+        },
+    ],
+    pica_physical_assets_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list your assets",
+            next_tool: "pica_physical_assets_query",
+        },
+    ],
+    pica_agreement_templates_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list your agreement templates",
+            next_tool: "pica_agreement_templates_list",
+        },
+    ],
+    pica_producer_agreements_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list your producer agreements",
+            next_tool: "pica_producer_agreements_list",
+        },
+    ],
+    pica_work_for_hire_delete: [
+        {
+            error_code: "NOT_FOUND",
+            suggestion: "list your work-for-hire agreements",
+            next_tool: "pica_work_for_hire_list",
+        },
+    ],
+    // ── enrichment tools ──
+    pica_enrich_work_spotify: [
+        {
+            error_code: "NO_MATCH",
+            suggestion: "no Spotify match — try MusicBrainz",
+            next_tool: "pica_enrich_work_musicbrainz",
+        },
+        {
+            error_code: "MISSING_INPUT",
+            suggestion: "provide a Spotify URL or ensure the work has a spotify_track_uri",
+            next_tool: "pica_works_update",
+        },
+    ],
+    pica_enrich_work_musicbrainz: [
+        {
+            error_code: "NO_MATCH",
+            suggestion: "no MusicBrainz match — try MLC",
+            next_tool: "pica_enrich_work_mlc",
+        },
+    ],
+    pica_enrich_work_mlc: [
+        {
+            error_code: "NO_MATCH",
+            suggestion: "no MLC match — try Discogs",
+            next_tool: "pica_enrich_work_discogs",
+        },
+        {
+            error_code: "CREDIT_INSUFFICIENT",
+            suggestion: "check your credit balance",
+            next_tool: "pica_credits_balance",
+        },
+    ],
+    pica_enrich_work_discogs: [
+        {
+            error_code: "NO_MATCH",
+            suggestion: "no Discogs match — try adding identifiers manually",
+            next_tool: "pica_works_update",
+        },
+    ],
+    pica_enrich_work_youtube: [
+        {
+            error_code: "NO_MATCH",
+            suggestion: "no YouTube data — ensure a YouTube video is linked",
+            next_tool: "pica_multimedia_link_youtube",
+        },
+    ],
+    pica_people_enrich_isni: [
+        {
+            error_code: "NO_MATCH",
+            suggestion: "no ISNI match — try MusicBrainz",
+            next_tool: "pica_people_enrich_musicbrainz",
+        },
+    ],
+    pica_people_enrich_musicbrainz: [
+        {
+            error_code: "NO_MATCH",
+            suggestion: "no MusicBrainz match — try adding identifiers manually",
+            next_tool: "pica_people_update",
+        },
+    ],
+    // ── mutating tools ──
+    pica_works_create: [
+        {
+            error_code: "DUPLICATE_WORK",
+            suggestion: "a similar work already exists — search first",
+            next_tool: "pica_works_query",
+        },
+    ],
+    pica_people_create: [
+        {
+            error_code: "DUPLICATE_PERSON",
+            suggestion: "a similar person already exists — search first",
+            next_tool: "pica_people_query",
+        },
+    ],
+    pica_credits_update: [
+        {
+            error_code: "SPLITS_NOT_100",
+            suggestion: "credit splits must total 100% — check current splits",
+            next_tool: "pica_credits_list",
+        },
+        {
+            error_code: "PERSON_NOT_FOUND",
+            suggestion: "person not in catalog — create them first",
+            next_tool: "pica_people_create",
+        },
+    ],
+    pica_split_sheet_generate: [
+        {
+            error_code: "SPLITS_NOT_100",
+            suggestion: "fix credits before generating split sheet",
+            next_tool: "pica_credits_update",
+        },
+    ],
+    pica_import_execute: [
+        {
+            error_code: "VALIDATION_ERROR",
+            suggestion: "validate the import first to see row-level issues",
+            next_tool: "pica_import_validate",
+        },
+    ],
+    pica_export_song_registration: [
+        {
+            error_code: "CREDIT_INSUFFICIENT",
+            suggestion: "song registration export costs 1 credit",
+            next_tool: "pica_credits_balance",
+        },
+    ],
+    pica_export_catalog_asset_report: [
+        {
+            error_code: "CREDIT_INSUFFICIENT",
+            suggestion: "catalog asset report costs 5 credits",
+            next_tool: "pica_credits_balance",
+        },
+    ],
+    pica_audio_analyze: [
+        {
+            error_code: "CREDIT_INSUFFICIENT",
+            suggestion: "audio analysis costs credits",
+            next_tool: "pica_credits_balance",
+        },
+    ],
+    pica_audio_identify: [
+        {
+            error_code: "NO_MATCH",
+            suggestion: "no fingerprint match — enter metadata manually",
+            next_tool: "pica_works_update",
+        },
+    ],
+    pica_notify_person: [
+        {
+            error_code: "NOT_PICA_USER",
+            suggestion: "person isn't on PICA — invite them first",
+            next_tool: "pica_collaborators_invite",
+        },
+    ],
+    pica_recordings_create: [
+        {
+            error_code: "DUPLICATE_ISRC",
+            suggestion: "recording with this ISRC already exists",
+            next_tool: "pica_recordings_by_work",
+        },
+    ],
+};
+export function getRecoveryHint(toolName, errorCode) {
+    const hints = RECOVERY_HINTS[toolName];
+    if (!hints)
+        return undefined;
+    return hints.find((h) => h.error_code === errorCode);
+}
+//# sourceMappingURL=recovery-hints.js.map

package/dist/tools/recovery-hints.js.map

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

package/dist/tools/releases.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Releases Tools — manage releases (albums, EPs, singles with release dates, labels, and UPCs)
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ReleasesTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listReleases;
+    private getRelease;
+    private createRelease;
+    private updateRelease;
+}
+//# sourceMappingURL=releases.d.ts.map

package/dist/tools/releases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../src/tools/releases.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAuG3D,YAAY;YAQZ,UAAU;YAKV,aAAa;YAMb,aAAa;CAK5B"}

package/dist/tools/releases.js

@@ -0,0 +1,128 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatStructuredList } from "@withpica/mcp-utils";
+export class ReleasesTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_releases_list",
+                    description: "List releases — albums, EPs, and singles with release dates, labels, and UPCs.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            limit: {
+                                type: "number",
+                                description: "Max results to return (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listReleases.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_releases_get",
+                    description: "Get release details including tracks.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Release ID" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getRelease.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_releases_create",
+                    description: "Create a new release — set the title, date, release type, label, and UPC.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            title: {
+                                type: "string",
+                                description: "Release title",
+                            },
+                            release_date: {
+                                type: "string",
+                                description: "Release date (YYYY-MM-DD)",
+                            },
+                            release_type: {
+                                type: "string",
+                                description: "Release type (album, ep, single, compilation)",
+                            },
+                            upc: {
+                                type: "string",
+                                description: "Universal Product Code (UPC/EAN barcode)",
+                            },
+                            catalog_number: {
+                                type: "string",
+                                description: "Label catalog number",
+                            },
+                        },
+                        required: ["title"],
+                    },
+                },
+                executor: this.createRelease.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_releases_update",
+                    description: "Update release details — title, date, release type, label, UPC, or catalog number.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Release ID" },
+                            title: { type: "string", description: "Updated title" },
+                            release_date: {
+                                type: "string",
+                                description: "Updated release date (YYYY-MM-DD)",
+                            },
+                            release_type: {
+                                type: "string",
+                                description: "Updated release type (album, ep, single, compilation)",
+                            },
+                            upc: {
+                                type: "string",
+                                description: "Updated UPC",
+                            },
+                            catalog_number: {
+                                type: "string",
+                                description: "Updated catalog number",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.updateRelease.bind(this),
+            },
+        ];
+    }
+    async listReleases(args) {
+        const result = await this.pica.releases.list({
+            limit: args.limit,
+        });
+        const releases = Array.isArray(result) ? result : [];
+        return formatStructuredList(releases, "release");
+    }
+    async getRelease(args) {
+        const release = await this.pica.releases.get(args.id);
+        return formatSuccess("Release retrieved", release);
+    }
+    async createRelease(args) {
+        const { id, ...data } = args;
+        const release = await this.pica.releases.create(data);
+        return formatSuccess("Release created", release);
+    }
+    async updateRelease(args) {
+        const { id, ...updates } = args;
+        const release = await this.pica.releases.update(id, updates);
+        return formatSuccess("Release updated", release);
+    }
+}
+//# sourceMappingURL=releases.js.map

package/dist/tools/releases.js.map

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

package/dist/tools/royalties.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Royalties & Statements MCP Tools — ADR-139 Step 2
+ *
+ * Un-cuts the royalty data layer that was archived in the March 2026
+ * UI simplification. The API routes and services still exist — these
+ * tools expose them to AI assistants.
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import type { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class RoyaltiesTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listPayments;
+    private getEarnings;
+    private getGaps;
+    private listStatements;
+    private getStatement;
+}
+//# sourceMappingURL=royalties.d.ts.map

package/dist/tools/royalties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"royalties.d.ts","sourceRoot":"","sources":["../../src/tools/royalties.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAO3E,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAsL3D,YAAY;YA2BZ,WAAW;YAWX,OAAO;YAkCP,cAAc;YAiBd,YAAY;CAW3B"}