@withpica/mcp-server 2.7.0 → 2.9.0

package/dist/tools/royalties.js

@@ -0,0 +1,257 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatAsText, } from "@withpica/mcp-utils";
+export class RoyaltiesTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_royalties_list",
+                    description: "List royalty payment records with optional filters. " +
+                        "Returns individual payment entries from imported statements.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            source: {
+                                type: "string",
+                                description: "Filter by payment source: prs, ppl, mcps, ascap, bmi, sesac, " +
+                                    "spotify, apple_music, youtube, distrokid, tunecore, cdbaby, etc.",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Filter by work ID (UUID)",
+                            },
+                            from_date: {
+                                type: "string",
+                                description: "Filter payments from date (ISO format YYYY-MM-DD)",
+                            },
+                            to_date: {
+                                type: "string",
+                                description: "Filter payments to date (ISO format YYYY-MM-DD)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of results (default 50, max 100)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset (default 0)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listPayments.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_royalties_get",
+                    description: "Get detailed earnings summary with breakdown by source and tax category. " +
+                        "Includes recent payment records and pagination. " +
+                        "Use this for questions like 'how much did I earn?' or 'what are my earnings?'.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            start_date: {
+                                type: "string",
+                                description: "Filter from date (ISO format YYYY-MM-DD)",
+                            },
+                            end_date: {
+                                type: "string",
+                                description: "Filter to date (ISO format YYYY-MM-DD)",
+                            },
+                            source: {
+                                type: "string",
+                                description: "Filter by source (prs, ppl, spotify, etc.)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of recent payments to return (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.getEarnings.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_royalties_summary",
+                    description: "Get royalty gap analysis — identifies missing registrations, " +
+                        "unlinked credits, and payment gaps. Answers questions like " +
+                        "'what am I missing?' or 'where should I register?'.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            priority: {
+                                type: "string",
+                                description: "Filter by priority: high, medium, low",
+                            },
+                            gap_type: {
+                                type: "string",
+                                description: "Filter by gap type: prs_missing, ppl_missing, mcps_missing, " +
+                                    "spotify_missing, isrc_missing, iswc_missing, tunecode_missing, " +
+                                    "payment_missing, credit_unlinked",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Filter gaps for a specific work",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of gaps to return (default 20)",
+                            },
+                        },
+                    },
+                },
+                executor: this.getGaps.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_statements_list",
+                    description: "List past statement imports — shows which PRO/NRO statements " +
+                        "have been imported and when. Supported sources: PRS, PPL, MCPS, " +
+                        "ASCAP, BMI, SESAC, SoundExchange, SOCAN, APRA.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            source: {
+                                type: "string",
+                                description: "Filter by source (prs, ppl, ascap, etc.)",
+                            },
+                            date_from: {
+                                type: "string",
+                                description: "Filter imports after this date (ISO format)",
+                            },
+                            date_to: {
+                                type: "string",
+                                description: "Filter imports before this date (ISO format)",
+                            },
+                            search: {
+                                type: "string",
+                                description: "Search by filename",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of results (default 20, max 50)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset",
+                            },
+                            sort: {
+                                type: "string",
+                                description: "Sort order: newest (default) or oldest",
+                            },
+                        },
+                    },
+                },
+                executor: this.listStatements.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_statements_get",
+                    description: "Get details of a specific statement import batch, including " +
+                        "line items with per-work/territory breakdowns.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            batch_id: {
+                                type: "string",
+                                description: "The import batch ID (UUID)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Number of line items to return (default 50, max 100)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset for line items",
+                            },
+                        },
+                        required: ["batch_id"],
+                    },
+                },
+                executor: this.getStatement.bind(this),
+            },
+        ];
+    }
+    async listPayments(args) {
+        const data = await this.pica.royalties.payments({
+            source: args.source,
+            workId: args.work_id,
+            fromDate: args.from_date,
+            toDate: args.to_date,
+            limit: args.limit || 50,
+            offset: args.offset || 0,
+        });
+        const hints = [];
+        if (!data?.length) {
+            hints.push({
+                gap: "no_payments",
+                suggestion: "Import a royalty statement to start tracking earnings (upload a PRS/PPL/ASCAP CSV)",
+                severity: "important",
+            });
+        }
+        return formatSuccess(`Found ${data?.length || 0} payment records`, data, hints);
+    }
+    async getEarnings(args) {
+        const data = await this.pica.royalties.earnings({
+            start_date: args.start_date,
+            end_date: args.end_date,
+            source: args.source,
+            limit: args.limit || 50,
+        });
+        return formatSuccess("Earnings summary", data);
+    }
+    async getGaps(args) {
+        const data = await this.pica.royalties.gaps({
+            priority: args.priority,
+            gapType: args.gap_type,
+            workId: args.work_id,
+            limit: args.limit || 20,
+        });
+        const hints = [];
+        const gaps = Array.isArray(data) ? data : [];
+        const prsGaps = gaps.filter((g) => g.gap_type === "prs_missing");
+        if (prsGaps.length > 0) {
+            hints.push({
+                gap: "prs_missing",
+                suggestion: `Register ${prsGaps.length} work(s) with PRS (pica_works_inspect with sections: ["registration"])`,
+                count: prsGaps.length,
+                severity: "critical",
+            });
+        }
+        const isrcGaps = gaps.filter((g) => g.gap_type === "isrc_missing");
+        if (isrcGaps.length > 0) {
+            hints.push({
+                gap: "isrc_missing",
+                suggestion: `Add ISRCs to ${isrcGaps.length} recording(s) for royalty tracking`,
+                count: isrcGaps.length,
+                severity: "important",
+            });
+        }
+        return formatSuccess(`Found ${gaps.length} royalty gaps`, data, hints);
+    }
+    async listStatements(args) {
+        const data = await this.pica.statements.history({
+            source: args.source,
+            dateFrom: args.date_from,
+            dateTo: args.date_to,
+            search: args.search,
+            limit: args.limit || 20,
+            offset: args.offset || 0,
+            sort: args.sort,
+        });
+        return formatSuccess(`Found ${data?.imports?.length || data?.total || 0} statement imports`, data);
+    }
+    async getStatement(args) {
+        if (!args.batch_id) {
+            return formatAsText({ error: "batch_id is required" });
+        }
+        const data = await this.pica.statements.get(args.batch_id);
+        return formatSuccess(`Statement batch: ${data?.sourceName || data?.source || "unknown"} — ${data?.lineItemCount || 0} line items`, data);
+    }
+}
+//# sourceMappingURL=royalties.js.map

package/dist/tools/royalties.js.map

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

package/dist/tools/search.d.ts

@@ -4,7 +4,7 @@
  * Uses the chain service for unified fuzzy search with pg_trgm across
  * works, people, recordings, physical assets, audio files, and work sessions.
  */
-import { PicaClient } from "../pica-sdk.js";
+import { PicaClient } from "@withpica/mcp-sdk";
 import { ToolDefinition, ToolExecutor } from "./index.js";
 export declare class SearchTools {
   private pica;

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,WAAW;IACtB,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;IAsEzE;;;OAGG;YACW,SAAS;IASvB;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,aAAa;CAoB5B"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,WAAW;IACtB,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;IAsEzE;;;OAGG;YACW,SAAS;IASvB;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,aAAa;CAoB5B"}

package/dist/tools/search.js

@@ -1,5 +1,5 @@
 // Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-import { formatAsText, formatSuccess } from "../utils/formatting.js";
+import { formatAsText, formatSuccess } from "@withpica/mcp-utils";
 export class SearchTools {
     pica;
     constructor(pica) {
@@ -12,7 +12,7 @@ export class SearchTools {
                     name: "pica_search_all",
                     description: "Fuzzy search across the entire catalog: works, people, recordings, physical assets, audio files, studio sessions, agreements, multimedia, and releases. " +
                         "Supports free text, ISRC, ISWC, and IPI lookups. Returns ranked results with the top match expanded to full chain detail. " +
-                        "→ then: pica_works_get_full (work details), pica_people_get_full (person details), pica_recordings_get (recording details)",
+                        "→ then: pica_works_inspect (work details), pica_people_inspect (person details), pica_recordings_inspect (recording details)",
                     inputSchema: {
                         type: "object",
                         properties: {
@@ -52,7 +52,7 @@ export class SearchTools {
                         "Returns the canonical global entity + all connected works, recordings, creators, and publishers across the graph. " +
                         "Also shows which entities exist in your catalog. " +
                         "Use this to answer: 'show me everything connected to this IPI/ISRC/ISWC' or 'what else has this person written?'\n\n" +
-                        "→ then: pica_works_get_full (deep-dive a work), pica_enrich_work (enrich a discovered work)",
+                        "→ then: pica_works_inspect (deep-dive a work), pica_enrich_work_spotify (enrich a discovered work)",
                     inputSchema: {
                         type: "object",
                         properties: {

package/dist/tools/search.js.map

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

package/dist/tools/send.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Send Tools - MCP tools for sending messages, invites, and file requests through PICA's Send Hub
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class SendTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private sendMessage;
+    private querySent;
+    private resendItem;
+}
+//# sourceMappingURL=send.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/tools/send.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,SAAS;IACpB,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;YAqJ3D,WAAW;YAaX,SAAS;YAwBT,UAAU;CAIzB"}

package/dist/tools/send.js

@@ -0,0 +1,185 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatList } from "@withpica/mcp-utils";
+export class SendTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_send_message",
+                    description: "Send a message through PICA's Send Hub. Supports portal invites, team invites, " +
+                        "project invites, file requests, and audio shares. Each send_type requires different fields.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            send_type: {
+                                type: "string",
+                                description: "Type of message to send",
+                                enum: [
+                                    "portal_invite",
+                                    "team_invite",
+                                    "project_invite",
+                                    "file_request",
+                                    "audio_share",
+                                ],
+                            },
+                            // Portal invite fields
+                            person_id: {
+                                type: "string",
+                                description: "Person ID to send to (required for portal_invite, optional for file_request/audio_share)",
+                            },
+                            email: {
+                                type: "string",
+                                description: "Email address (required for portal_invite, team_invite)",
+                            },
+                            message: {
+                                type: "string",
+                                description: "Optional personal message to include",
+                            },
+                            // Team invite fields
+                            name: {
+                                type: "string",
+                                description: "Recipient name (for team_invite)",
+                            },
+                            permissions: {
+                                type: "string",
+                                description: "Permission level for team_invite (e.g. 'admin', 'editor', 'viewer')",
+                            },
+                            // Project invite fields
+                            project_id: {
+                                type: "string",
+                                description: "Project ID (required for project_invite)",
+                            },
+                            participant_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "List of person IDs to invite to the project",
+                            },
+                            // File request fields
+                            title: {
+                                type: "string",
+                                description: "Title for file_request",
+                            },
+                            recipient_email: {
+                                type: "string",
+                                description: "Recipient email for file_request/audio_share",
+                            },
+                            recipient_name: {
+                                type: "string",
+                                description: "Recipient name for file_request/audio_share",
+                            },
+                            // Audio share fields
+                            work_id: {
+                                type: "string",
+                                description: "Work ID (required for audio_share)",
+                            },
+                            allow_download: {
+                                type: "boolean",
+                                description: "Allow downloading shared audio files",
+                            },
+                        },
+                        required: ["send_type"],
+                    },
+                },
+                executor: this.sendMessage.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_send_query",
+                    description: "Query Send Hub items with optional filters. Returns sent messages, " +
+                        "invites, file requests, and audio shares. Use status='pending' to see items awaiting response.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            status: {
+                                type: "string",
+                                description: "Filter by status: 'all' for everything, 'sent' for delivered, 'pending' for awaiting response (default: all)",
+                                enum: ["all", "sent", "pending"],
+                            },
+                            type: {
+                                type: "string",
+                                description: "Filter by type",
+                                enum: [
+                                    "portal_invite",
+                                    "team_invite",
+                                    "project_invite",
+                                    "file_request",
+                                    "audio_share",
+                                ],
+                            },
+                            person_id: {
+                                type: "string",
+                                description: "Filter by recipient person ID",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Filter by related work ID",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results (default: 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.querySent.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_send_resend",
+                    description: "Resend a Send Hub item (re-send an invite, file request, or audio share).",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Send Hub item ID to resend",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.resendItem.bind(this),
+            },
+        ];
+    }
+    async sendMessage(args) {
+        // Remap person_id → recipient_person_id for file_request/audio_share
+        if ((args.send_type === "file_request" || args.send_type === "audio_share") &&
+            args.person_id &&
+            !args.recipient_person_id) {
+            args.recipient_person_id = args.person_id;
+        }
+        const result = await this.pica.send.send(args);
+        return formatSuccess(`${args.send_type} sent successfully.`, result);
+    }
+    async querySent(args) {
+        const status = args.status || "all";
+        // "pending" delegates to the dedicated pending endpoint
+        if (status === "pending") {
+            const items = await this.pica.send.listPending();
+            return formatList(items, { status: "pending" });
+        }
+        // "all" or "sent" use the general list endpoint
+        const result = await this.pica.send.list({
+            type: args.type,
+            status: status === "all" ? args.status : status,
+            personId: args.person_id,
+            workId: args.work_id,
+            limit: args.limit,
+        });
+        return formatList(result.items, {
+            total: result.total,
+            type: args.type,
+            status: args.status,
+        });
+    }
+    async resendItem(args) {
+        const result = await this.pica.send.resend(args.id);
+        return formatSuccess(`Item ${args.id} resent.`, result);
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/tools/send.js.map

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

package/dist/tools/sessions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Work Sessions Tools - MCP tools for tracking studio sessions
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class SessionsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listSessions;
+    private getSession;
+    private createSession;
+    private getSessionTypes;
+}
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAOtE,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;YA0F3D,YAAY;YAQZ,UAAU;YAKV,aAAa;YAWb,eAAe;CAM9B"}