@withpica/mcp-server 2.1.0

package/dist/tools/enrichment.js

@@ -0,0 +1,207 @@
+/**
+ * Enrichment Tools - MCP tools for triggering and checking enrichment
+ */
+import { formatAsText, formatSuccess } from "../utils/formatting.js";
+import { withCreditGate } from "../utils/credit-gate.js";
+export class EnrichmentTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_enrich_work",
+                    description: "Trigger enrichment for a work (fetches data from MLC, MusicBrainz, etc.). " +
+                        "→ then: pica_enrichment_status (check results), pica_work_completeness (verify improvement) Costs 1 pica credit (MLC lookup).",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to enrich",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: withCreditGate(this.pica, "external_mlc_lookup", "work enrichment (MLC)", this.enrichWork.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_person",
+                    description: "Trigger enrichment for a person (fetches data from ISNI, MusicBrainz, etc.). " +
+                        "→ then: pica_people_get_full (verify results) Costs 1 pica credit (MLC lookup). ISNI and MusicBrainz are free.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            person_id: {
+                                type: "string",
+                                description: "The person ID to enrich",
+                            },
+                        },
+                        required: ["person_id"],
+                    },
+                },
+                executor: withCreditGate(this.pica, "external_mlc_lookup", "person enrichment", this.enrichPerson.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_enrichment_status",
+                    description: "Check the enrichment status for a specific work (what sources have been checked, what data was found)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to check",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.enrichmentStatus.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_enrichment_candidates",
+                    description: "Find works and people that are candidates for enrichment (missing external identifiers or metadata). " +
+                        "→ then: pica_enrich_work (enrich a work), pica_enrich_person (enrich a person)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.enrichmentCandidates.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_mlc",
+                    description: "Check MLC (Mechanical Licensing Collective) for publishing details on a work — writers, publishers, and splits. " +
+                        "Use this when you want to find out if a work has publishing registrations. Costs 1 pica credit.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to check MLC for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: withCreditGate(this.pica, "external_mlc_lookup", "MLC lookup", this.enrichWorkMlc.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_musicbrainz",
+                    description: "Look up MusicBrainz for release data, artist info, and cross-references for a work. " +
+                        "Returns a preview of what MusicBrainz knows — use pica_enrich_work to apply changes.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to look up on MusicBrainz",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.enrichWorkMusicBrainz.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_discogs",
+                    description: "Search Discogs for release data, label, format, and catalogue numbers for a work. " +
+                        "Returns a preview of matches — use pica_enrich_work to apply changes.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to search Discogs for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.enrichWorkDiscogs.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_spotify",
+                    description: "Enrich a work from Spotify — pulls artwork, preview URLs, popularity, ISRC, label, and release date. " +
+                        "The work must already have a spotify_track_uri linked.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to enrich from Spotify",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.enrichWorkSpotify.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_enrich_work_youtube",
+                    description: "Enrich a work from YouTube — pulls view count, like count, channel info, and video duration. " +
+                        "The work must already have a youtube_video_id linked.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to enrich from YouTube",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.enrichWorkYouTube.bind(this),
+            },
+        ];
+    }
+    async enrichWork(args) {
+        const result = await this.pica.enrichment.enrichWork(args.work_id);
+        return formatSuccess(`Enrichment triggered for work ${args.work_id}`, result);
+    }
+    async enrichPerson(args) {
+        const result = await this.pica.enrichment.enrichPerson(args.person_id);
+        return formatSuccess(`Enrichment triggered for person ${args.person_id}`, result);
+    }
+    async enrichmentStatus(args) {
+        const result = await this.pica.enrichment.getWorkEnrichmentStatus(args.work_id);
+        return formatAsText(result);
+    }
+    async enrichmentCandidates(_args) {
+        const result = await this.pica.enrichment.getCandidates();
+        return formatAsText(result);
+    }
+    async enrichWorkMlc(args) {
+        const result = await this.pica.enrichment.enrichWorkMlc(args.work_id);
+        return formatSuccess(`MLC lookup complete for work ${args.work_id}`, result);
+    }
+    async enrichWorkMusicBrainz(args) {
+        const result = await this.pica.enrichment.enrichWorkMusicBrainz(args.work_id);
+        return formatAsText(result);
+    }
+    async enrichWorkDiscogs(args) {
+        const result = await this.pica.enrichment.enrichWorkDiscogs(args.work_id);
+        return formatAsText(result);
+    }
+    async enrichWorkSpotify(args) {
+        const result = await this.pica.enrichment.enrichWorkSpotify(args.work_id);
+        return formatSuccess(`Spotify enrichment complete for work ${args.work_id}`, result);
+    }
+    async enrichWorkYouTube(args) {
+        const result = await this.pica.enrichment.enrichWorkYouTube(args.work_id);
+        return formatSuccess(`YouTube enrichment complete for work ${args.work_id}`, result);
+    }
+}
+//# sourceMappingURL=enrichment.js.map

package/dist/tools/enrichment.js.map

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

package/dist/tools/exports.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Export Tools - MCP tools for exporting catalog data
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ExportTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private exportCatalogCsv;
+    private exportSongRegistration;
+    private exportIndustryReady;
+    private exportCatalogAssetReport;
+    private exportAiConsent;
+}
+//# sourceMappingURL=exports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/tools/exports.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAItE,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;YAuH3D,gBAAgB;YAShB,sBAAsB;YAOtB,mBAAmB;YAOnB,wBAAwB;YAqCxB,eAAe;CAS9B"}

package/dist/tools/exports.js

@@ -0,0 +1,155 @@
+/**
+ * Export Tools - MCP tools for exporting catalog data
+ */
+import { formatAsText, formatSuccess } from "../utils/formatting.js";
+import { withCreditGate } from "../utils/credit-gate.js";
+export class ExportTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_export_catalog_csv",
+                    description: "Export the full works catalog as CSV data",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            format: {
+                                type: "string",
+                                enum: ["csv", "json"],
+                                description: "Export format (default: csv)",
+                            },
+                        },
+                    },
+                },
+                executor: this.exportCatalogCsv.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_export_song_registration",
+                    description: "Export catalog in song registration format (CWR-compatible) for PRO/CMO registration. Costs 1 pica credit.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: withCreditGate(this.pica, "export_song_registration", "song registration export", this.exportSongRegistration.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_export_industry_ready",
+                    description: "Export industry-ready metadata package — formatted for distribution to publishers, labels, and sync agents. Costs 1 pica credit.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: withCreditGate(this.pica, "export_industry_csv", "industry-ready export", this.exportIndustryReady.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_export_catalog_asset_report",
+                    description: "Generate a Catalog Asset Report (CAR) — a unified ZIP bundle with cover PDF, evidence folders, and integrity manifest. Maps creative portfolio data to property-lending equivalents for financial institutions, insurers, PROs, and distributors. Sections include: ownership (title deed equivalent), valuation (surveyor's report), physical assets (contents schedule), agreements (mortgage deed), catalog intelligence (condition report), and summary with equivalence map. Costs 5 pica credits. Check pica_credits_balance first.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            sections: {
+                                type: "object",
+                                description: "Which sections to include in the export. Ownership is always included.",
+                                properties: {
+                                    valuation: {
+                                        type: "boolean",
+                                        description: "Include earnings, audio intelligence, DSP presence, completeness scores",
+                                    },
+                                    assets: {
+                                        type: "boolean",
+                                        description: "Include physical asset register with insurance and valuations",
+                                    },
+                                    agreements: {
+                                        type: "boolean",
+                                        description: "Include agreements structure and AI consent status",
+                                    },
+                                    intelligence: {
+                                        type: "boolean",
+                                        description: "Include gap analysis, carbon footprint, diligence readiness",
+                                    },
+                                    audio: {
+                                        type: "boolean",
+                                        description: "Include audio master files (large, opt-in)",
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+                executor: withCreditGate(this.pica, "export_catalog_asset_report", "catalog asset report", this.exportCatalogAssetReport.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_export_ai_consent",
+                    description: "Export AI usage consent declarations for all works — " +
+                        "shows which works are human-made, AI-assisted, or AI-generated, " +
+                        "with contributor-level consent tracking for AI model training and licensing.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.exportAiConsent.bind(this),
+            },
+        ];
+    }
+    async exportCatalogCsv(args) {
+        const result = await this.pica.exports.catalogCsv({
+            format: args.format,
+        });
+        return formatAsText(result);
+    }
+    async exportSongRegistration(_args) {
+        const result = await this.pica.exports.songRegistration();
+        return formatSuccess("Song registration export generated", result);
+    }
+    async exportIndustryReady(_args) {
+        const result = await this.pica.exports.industryReady();
+        return formatSuccess("Industry-ready export generated", result);
+    }
+    async exportCatalogAssetReport(args) {
+        const sections = {
+            ownership: true,
+            valuation: args.sections?.valuation ?? true,
+            assets: args.sections?.assets ?? true,
+            agreements: args.sections?.agreements ?? true,
+            intelligence: args.sections?.intelligence ?? true,
+            audio: args.sections?.audio ?? false,
+        };
+        const result = await this.pica.exports.catalogAssetReport({
+            sections,
+            attestation: {
+                signer_name: "MCP Agent",
+                declaration_accepted: true,
+            },
+        });
+        const data = result?.data ?? result;
+        const summary = [
+            `Catalog Asset Report generated`,
+            `Stage: ${data.stage ?? "unknown"}`,
+            `PICA Score: ${data.pica_score ?? "N/A"}${data.pica_grade ? ` (${data.pica_grade})` : ""}`,
+            `Sections: ownership${sections.valuation ? ", valuation" : ""}${sections.assets ? ", assets" : ""}${sections.agreements ? ", agreements" : ""}${sections.intelligence ? ", intelligence" : ""}${sections.audio ? ", audio" : ""}`,
+            data.file_size_bytes
+                ? `Size: ${(data.file_size_bytes / 1024).toFixed(1)} KB`
+                : null,
+            data.download_url ? `Download: ${data.download_url}` : null,
+        ]
+            .filter(Boolean)
+            .join("\n");
+        return formatSuccess(summary, data);
+    }
+    async exportAiConsent(_args) {
+        const result = await this.pica.exports.aiConsent();
+        return formatSuccess("AI consent declarations exported — shows disclosure level and training rights per work", result);
+    }
+}
+//# sourceMappingURL=exports.js.map

package/dist/tools/exports.js.map

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

package/dist/tools/health.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Health Tools - MCP tools for work health and completeness scoring
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class HealthTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private worksHealth;
+    private completenessLow;
+    private workCompleteness;
+}
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/tools/health.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,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;YAkD3D,WAAW;YAKX,eAAe;YAOf,gBAAgB;CAM/B"}

package/dist/tools/health.js

@@ -0,0 +1,69 @@
+/**
+ * Health Tools - MCP tools for work health and completeness scoring
+ */
+import { formatAsText } from "../utils/formatting.js";
+export class HealthTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_works_health",
+                    description: "Get works that need attention — missing credits, no ISWC, incomplete metadata, etc. " +
+                        "→ then: pica_works_get_full (inspect a work), pica_work_completeness (detailed gap check)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.worksHealth.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_completeness_low",
+                    description: "Get works with low completeness scores — works that need the most improvement. " +
+                        "→ then: pica_work_completeness (detailed gaps), pica_works_get_full (inspect a work)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.completenessLow.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_work_completeness",
+                    description: "Get the detailed completeness score for a specific work — shows what's missing and what's complete. " +
+                        "→ then: pica_credits_update (fix credits), pica_enrich_work (fill identifiers), pica_audio_presigned_upload (add audio)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to get completeness for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.workCompleteness.bind(this),
+            },
+        ];
+    }
+    async worksHealth(_args) {
+        const result = await this.pica.health.getWorksHealth();
+        return formatAsText(result);
+    }
+    async completenessLow(_args) {
+        const result = await this.pica.health.getLowScoreWorks();
+        return formatAsText(result);
+    }
+    async workCompleteness(args) {
+        const result = await this.pica.health.getWorkCompleteness(args.work_id);
+        return formatAsText(result);
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/tools/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/tools/health.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,OAAO,WAAW;IACd,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,mBAAmB;oBACzB,WAAW,EACT,sFAAsF;wBACtF,2FAA2F;oBAC7F,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE;qBACf;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;aACtC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,uBAAuB;oBAC7B,WAAW,EACT,iFAAiF;wBACjF,sFAAsF;oBACxF,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE;qBACf;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;aAC1C;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,wBAAwB;oBAC9B,WAAW,EACT,sGAAsG;wBACtG,yHAAyH;oBAC3H,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,qCAAqC;6BACnD;yBACF;wBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;qBACtB;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC3C;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,KAA0B;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACvD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,KAA0B;QAE1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACzD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,IAAyB;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/tools/import-documents.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Import Documents Tools - MCP tools for canonical ingestion documents
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ImportDocumentTools {
+    private pica;
+    constructor(pica: PicaClient);
+    /**
+     * Get all import document tools
+     */
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listImportDocuments;
+    private getImportDocument;
+    private ingestStatement;
+    private diffImportDocuments;
+}
+//# sourceMappingURL=import-documents.d.ts.map

package/dist/tools/import-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-documents.d.ts","sourceRoot":"","sources":["../../src/tools/import-documents.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,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAgG3D,mBAAmB;YAOnB,iBAAiB;YAkBjB,eAAe;YAgBf,mBAAmB;CA0ElC"}