@withpica/mcp-server 2.1.0

package/dist/tools/agreements.js

@@ -0,0 +1,328 @@
+/**
+ * Agreements Tools - MCP tools for managing agreements and contracts
+ */
+import { formatAsText, formatList, formatSuccess, } from "../utils/formatting.js";
+export class AgreementsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_agreements_list",
+                    description: "List agreements with optional filters. Returns contracts, publishing deals, and other agreements.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            query: {
+                                type: "string",
+                                description: "Search by title or party name",
+                            },
+                            agreement_type: {
+                                type: "string",
+                                description: "Filter by agreement type",
+                                enum: [
+                                    "master_recording",
+                                    "library_music",
+                                    "publishing_admin",
+                                    "production",
+                                    "artist_contract",
+                                    "termination",
+                                    "report",
+                                    "other",
+                                ],
+                            },
+                            status: {
+                                type: "string",
+                                description: "Filter by status",
+                                enum: [
+                                    "draft",
+                                    "pending_signature",
+                                    "partially_signed",
+                                    "fully_executed",
+                                    "active",
+                                    "completed",
+                                    "terminated",
+                                    "expired",
+                                    "cancelled",
+                                    "unknown",
+                                ],
+                            },
+                            party_name: {
+                                type: "string",
+                                description: "Filter by other party name",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Maximum results (default: 50, max: 100)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Pagination offset (default: 0)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listAgreements.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_get",
+                    description: "Get a single agreement with full details including signature status and linked works.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getAgreement.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_create",
+                    description: "Create a new agreement. Requires title, type, and other party name.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            title: {
+                                type: "string",
+                                description: "Agreement title",
+                            },
+                            agreement_type: {
+                                type: "string",
+                                description: "Type of agreement",
+                                enum: [
+                                    "master_recording",
+                                    "library_music",
+                                    "publishing_admin",
+                                    "production",
+                                    "artist_contract",
+                                    "termination",
+                                    "report",
+                                    "other",
+                                ],
+                            },
+                            other_party_name: {
+                                type: "string",
+                                description: "Name of the other party (label, publisher, etc.)",
+                            },
+                            status: {
+                                type: "string",
+                                description: "Initial status (default: draft)",
+                                enum: [
+                                    "draft",
+                                    "pending_signature",
+                                    "partially_signed",
+                                    "fully_executed",
+                                    "active",
+                                    "completed",
+                                    "terminated",
+                                    "expired",
+                                    "cancelled",
+                                ],
+                            },
+                            other_party_type: {
+                                type: "string",
+                                description: "Type of the other party (e.g., label, publisher, distributor)",
+                            },
+                            signing_date: {
+                                type: "string",
+                                description: "Date the agreement was signed (ISO 8601)",
+                            },
+                            start_date: {
+                                type: "string",
+                                description: "Start date of the agreement term (ISO 8601)",
+                            },
+                            end_date: {
+                                type: "string",
+                                description: "End date of the agreement term (ISO 8601)",
+                            },
+                            description: {
+                                type: "string",
+                                description: "Description of the agreement",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Internal notes",
+                            },
+                        },
+                        required: ["title", "agreement_type", "other_party_name"],
+                    },
+                },
+                executor: this.createAgreement.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_update",
+                    description: "Update an existing agreement. Status changes trigger notifications.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                            title: {
+                                type: "string",
+                                description: "Updated title",
+                            },
+                            status: {
+                                type: "string",
+                                description: "Updated status",
+                                enum: [
+                                    "draft",
+                                    "pending_signature",
+                                    "partially_signed",
+                                    "fully_executed",
+                                    "active",
+                                    "completed",
+                                    "terminated",
+                                    "expired",
+                                    "cancelled",
+                                ],
+                            },
+                            other_party_name: {
+                                type: "string",
+                                description: "Updated other party name",
+                            },
+                            signing_date: {
+                                type: "string",
+                                description: "Updated signing date (ISO 8601)",
+                            },
+                            start_date: {
+                                type: "string",
+                                description: "Updated start date (ISO 8601)",
+                            },
+                            end_date: {
+                                type: "string",
+                                description: "Updated end date (ISO 8601)",
+                            },
+                            description: {
+                                type: "string",
+                                description: "Updated description",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Updated internal notes",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.updateAgreement.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_delete",
+                    description: "Delete an agreement",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.deleteAgreement.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_link_work",
+                    description: "Link a work to an agreement. Optionally set a royalty split percentage.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            agreement_id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Work ID to link",
+                            },
+                            royalty_split_percentage: {
+                                type: "number",
+                                description: "Royalty split percentage for this work (0-100)",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Notes about this work's inclusion in the agreement",
+                            },
+                        },
+                        required: ["agreement_id", "work_id"],
+                    },
+                },
+                executor: this.linkWork.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_agreements_works",
+                    description: "List all works linked to an agreement",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            agreement_id: {
+                                type: "string",
+                                description: "Agreement ID",
+                            },
+                        },
+                        required: ["agreement_id"],
+                    },
+                },
+                executor: this.getAgreementWorks.bind(this),
+            },
+        ];
+    }
+    async listAgreements(args) {
+        const agreements = await this.pica.agreements.list({
+            query: args.query,
+            agreement_type: args.agreement_type,
+            status: args.status,
+            party_name: args.party_name,
+            includeWorkCounts: true,
+            limit: args.limit,
+            offset: args.offset,
+        });
+        return formatList(agreements, { total: agreements.length });
+    }
+    async getAgreement(args) {
+        const result = await this.pica.agreements.get(args.id);
+        return formatAsText(result);
+    }
+    async createAgreement(args) {
+        const agreement = await this.pica.agreements.create(args);
+        return formatSuccess("Agreement created", agreement);
+    }
+    async updateAgreement(args) {
+        const { id, ...updates } = args;
+        const agreement = await this.pica.agreements.update(id, updates);
+        return formatSuccess("Agreement updated", agreement);
+    }
+    async deleteAgreement(args) {
+        await this.pica.agreements.delete(args.id);
+        return formatSuccess(`Agreement ${args.id} deleted`);
+    }
+    async linkWork(args) {
+        const link = await this.pica.agreements.linkWork(args.agreement_id, {
+            work_id: args.work_id,
+            royalty_split_percentage: args.royalty_split_percentage,
+            notes: args.notes,
+        });
+        return formatSuccess("Work linked to agreement", link);
+    }
+    async getAgreementWorks(args) {
+        const works = await this.pica.agreements.getWorks(args.agreement_id);
+        return formatList(works, { agreement_id: args.agreement_id });
+    }
+}
+//# sourceMappingURL=agreements.js.map

package/dist/tools/agreements.js.map

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

package/dist/tools/analytics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Analytics & Reporting Tools — carbon footprint, provenance, catalog diligence
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class AnalyticsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private carbonSummary;
+    private carbonLive;
+    private provenanceStats;
+    private provenanceWork;
+    private provenanceCertificate;
+    private catalogDiligence;
+}
+//# sourceMappingURL=analytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/tools/analytics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,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;YAkG3D,aAAa;YAKb,UAAU;YAKV,eAAe;YAOf,cAAc;YAKd,qBAAqB;YAYrB,gBAAgB;CAM/B"}

package/dist/tools/analytics.js

@@ -0,0 +1,126 @@
+/**
+ * Analytics & Reporting Tools — carbon footprint, provenance, catalog diligence
+ */
+import { formatAsText, formatSuccess } from "../utils/formatting.js";
+export class AnalyticsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            // --- Carbon footprint ---
+            {
+                definition: {
+                    name: "pica_carbon_footprint",
+                    description: "Get the carbon footprint summary for your catalog — " +
+                        "streaming, physical distribution, and production emissions.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.carbonSummary.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_carbon_live",
+                    description: "Get live/real-time carbon metrics for ongoing streaming and distribution activity.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.carbonLive.bind(this),
+            },
+            // --- Provenance ---
+            {
+                definition: {
+                    name: "pica_provenance_stats",
+                    description: "Get provenance statistics — how many works have chain-of-title records, " +
+                        "attestation coverage, and verification status.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.provenanceStats.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_provenance_work",
+                    description: "Get the full provenance chain for a specific work — " +
+                        "creation history, ownership transfers, attestations, and verification entries.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to get provenance for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.provenanceWork.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_provenance_certificate",
+                    description: "Generate a provenance certificate for a work — " +
+                        "a downloadable chain-of-title document with attestation details.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to generate a certificate for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.provenanceCertificate.bind(this),
+            },
+            // --- Catalog diligence ---
+            {
+                definition: {
+                    name: "pica_catalog_diligence",
+                    description: "Generate a technical due diligence report for the catalog — " +
+                        "ownership clarity, registration coverage, identifier completeness, " +
+                        "and readiness for lending, licensing, or acquisition.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.catalogDiligence.bind(this),
+            },
+        ];
+    }
+    async carbonSummary(_args) {
+        const result = await this.pica.analytics.carbonSummary();
+        return formatSuccess("Carbon footprint summary", result);
+    }
+    async carbonLive(_args) {
+        const result = await this.pica.analytics.carbonLive();
+        return formatSuccess("Live carbon metrics", result);
+    }
+    async provenanceStats(_args) {
+        const result = await this.pica.analytics.provenanceStats();
+        return formatAsText(result);
+    }
+    async provenanceWork(args) {
+        const result = await this.pica.analytics.provenanceWork(args.work_id);
+        return formatAsText(result);
+    }
+    async provenanceCertificate(args) {
+        const result = await this.pica.analytics.provenanceCertificate(args.work_id);
+        return formatSuccess(`Provenance certificate generated for work ${args.work_id}`, result);
+    }
+    async catalogDiligence(_args) {
+        const result = await this.pica.analytics.catalogDiligence();
+        return formatSuccess("Catalog diligence report", result);
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/tools/analytics.js.map

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

package/dist/tools/assets.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Physical Assets Tools - MCP tools for managing equipment, instruments, and studio gear
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class AssetsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listAssets;
+    private getAsset;
+    private createAsset;
+    private updateAsset;
+    private deleteAsset;
+    private assetStats;
+    private assetValuations;
+    private assetMarketCheck;
+    private assetExport;
+}
+//# sourceMappingURL=assets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/tools/assets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAOtE,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;YAmL3D,UAAU;YAWV,QAAQ;YAKR,WAAW;YAKX,WAAW;YAMX,WAAW;YAKX,UAAU;YAKV,eAAe;YAOf,gBAAgB;YAOhB,WAAW;CAI1B"}