@withpica/mcp-server 2.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../src/tools/people.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAQtE,qBAAa,WAAW;IACtB,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;IA+ZzE;;OAEG;YACW,UAAU;IAqBxB;;OAEG;YACW,SAAS;IAKvB;;OAEG;YACW,YAAY;IA8B1B;;OAEG;YACW,YAAY;IAM1B;;OAEG;YACW,YAAY;IAK1B;;OAEG;YACW,YAAY;IAmB1B;;OAEG;YACW,cAAc;IAK5B;;OAEG;YACW,qBAAqB;IAanC;;OAEG;YACW,aAAa;CAoB5B"}

package/dist/tools/people.js

@@ -0,0 +1,534 @@
+/**
+ * People Tools - MCP tools for managing people (artists, composers, etc.)
+ */
+import { formatAsText, formatSuccess, formatStructuredList, } from "../utils/formatting.js";
+export class PeopleTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    /**
+     * Get all people tools
+     */
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_people_list",
+                    description: "List people (artists, composers, etc.) from PICA catalog",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            limit: {
+                                type: "number",
+                                description: "Maximum number of results to return (default: 50)",
+                            },
+                            search: {
+                                type: "string",
+                                description: "Search query to filter people by name",
+                            },
+                        },
+                    },
+                },
+                executor: this.listPeople.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_get",
+                    description: "Get details of a specific person by ID",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Person ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getPerson.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_create",
+                    description: "Create a new person record. Any field from the Person schema can be passed — " +
+                        "the most commonly used fields are listed below. Additional fields " +
+                        "(e.g. pro_name, pro_member_number, mcps_member_number, default_publisher, " +
+                        "default_publisher_ipi, company, position, territory, social_media) " +
+                        "are also accepted. " +
+                        "→ then: pica_enrich_person (fill identifiers), pica_credits_update (add to work)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            first_name: {
+                                type: "string",
+                                description: "First name (required)",
+                            },
+                            last_name: {
+                                type: "string",
+                                description: "Last name (required)",
+                            },
+                            roles: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Roles (e.g. ['artist', 'songwriter', 'producer']). Maps to the roles array column.",
+                            },
+                            email: {
+                                type: "string",
+                                description: "Email address",
+                            },
+                            phone: {
+                                type: "string",
+                                description: "Phone number",
+                            },
+                            biography: {
+                                type: "string",
+                                description: "Biography text",
+                            },
+                            stage_name: {
+                                type: "string",
+                                description: "Primary stage/artist name",
+                            },
+                            stage_names: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "All stage/artist names",
+                            },
+                            isni: {
+                                type: "string",
+                                description: "ISNI identifier (16-digit)",
+                            },
+                            cae_ipi_number: {
+                                type: "string",
+                                description: "CAE/IPI number (songwriter/publisher identifier)",
+                            },
+                            ipn_number: {
+                                type: "string",
+                                description: "IPN number (performer identifier)",
+                            },
+                            prs_number: {
+                                type: "string",
+                                description: "PRS member number",
+                            },
+                            ppl_number: {
+                                type: "string",
+                                description: "PPL member number",
+                            },
+                            musicbrainz_id: {
+                                type: "string",
+                                description: "MusicBrainz artist ID",
+                            },
+                            wikidata_id: {
+                                type: "string",
+                                description: "Wikidata entity ID (e.g. Q12345)",
+                            },
+                            discogs_artist_id: {
+                                type: "string",
+                                description: "Discogs artist ID",
+                            },
+                            deezer_artist_id: {
+                                type: "string",
+                                description: "Deezer artist ID",
+                            },
+                            website: {
+                                type: "string",
+                                description: "Website URL",
+                            },
+                            date_of_birth: {
+                                type: "string",
+                                description: "Date of birth (ISO 8601)",
+                            },
+                            nationality: {
+                                type: "string",
+                                description: "Nationality",
+                            },
+                            gender: {
+                                type: "string",
+                                description: "Gender",
+                            },
+                            birth_place: {
+                                type: "string",
+                                description: "Place of birth",
+                            },
+                            instruments: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Instruments played",
+                            },
+                            career_start_year: {
+                                type: "number",
+                                description: "Year career started",
+                            },
+                            tags: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Tags for categorisation",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Internal notes",
+                            },
+                            profile_image_url: {
+                                type: "string",
+                                description: "URL to profile image",
+                            },
+                        },
+                        required: ["first_name", "last_name"],
+                        additionalProperties: true,
+                    },
+                },
+                executor: this.createPerson.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_update",
+                    description: "Update an existing person record. Any field from the Person schema can be passed — " +
+                        "the most commonly used fields are listed below. Additional fields are also accepted.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Person ID (required)",
+                            },
+                            first_name: {
+                                type: "string",
+                                description: "First name",
+                            },
+                            last_name: {
+                                type: "string",
+                                description: "Last name",
+                            },
+                            roles: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Roles (e.g. ['artist', 'songwriter', 'producer'])",
+                            },
+                            email: {
+                                type: "string",
+                                description: "Email address",
+                            },
+                            phone: {
+                                type: "string",
+                                description: "Phone number",
+                            },
+                            biography: {
+                                type: "string",
+                                description: "Biography text",
+                            },
+                            stage_name: {
+                                type: "string",
+                                description: "Primary stage/artist name",
+                            },
+                            stage_names: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "All stage/artist names",
+                            },
+                            isni: {
+                                type: "string",
+                                description: "ISNI identifier (16-digit)",
+                            },
+                            cae_ipi_number: {
+                                type: "string",
+                                description: "CAE/IPI number (songwriter/publisher identifier)",
+                            },
+                            ipn_number: {
+                                type: "string",
+                                description: "IPN number (performer identifier)",
+                            },
+                            prs_number: {
+                                type: "string",
+                                description: "PRS member number",
+                            },
+                            ppl_number: {
+                                type: "string",
+                                description: "PPL member number",
+                            },
+                            musicbrainz_id: {
+                                type: "string",
+                                description: "MusicBrainz artist ID",
+                            },
+                            wikidata_id: {
+                                type: "string",
+                                description: "Wikidata entity ID (e.g. Q12345)",
+                            },
+                            discogs_artist_id: {
+                                type: "string",
+                                description: "Discogs artist ID",
+                            },
+                            deezer_artist_id: {
+                                type: "string",
+                                description: "Deezer artist ID",
+                            },
+                            website: {
+                                type: "string",
+                                description: "Website URL",
+                            },
+                            date_of_birth: {
+                                type: "string",
+                                description: "Date of birth (ISO 8601)",
+                            },
+                            nationality: {
+                                type: "string",
+                                description: "Nationality",
+                            },
+                            gender: {
+                                type: "string",
+                                description: "Gender",
+                            },
+                            birth_place: {
+                                type: "string",
+                                description: "Place of birth",
+                            },
+                            instruments: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Instruments played",
+                            },
+                            career_start_year: {
+                                type: "number",
+                                description: "Year career started",
+                            },
+                            tags: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Tags for categorisation",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Internal notes",
+                            },
+                            profile_image_url: {
+                                type: "string",
+                                description: "URL to profile image",
+                            },
+                        },
+                        required: ["id"],
+                        additionalProperties: true,
+                    },
+                },
+                executor: this.updatePerson.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_delete",
+                    description: "Delete a person record",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Person ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.deletePerson.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_search",
+                    description: "Search people by name or other criteria. " +
+                        "→ then: pica_people_get_full (full details), pica_enrich_person (fill identifiers), pica_credits_update (add to work)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            query: {
+                                type: "string",
+                                description: "Search query",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Maximum number of results (default: 50)",
+                            },
+                        },
+                        required: ["query"],
+                    },
+                },
+                executor: this.searchPeople.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_enrich_isni",
+                    description: "Enrich person data from ISNI (International Standard Name Identifier)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Person ID",
+                            },
+                            isni: {
+                                type: "string",
+                                description: "ISNI identifier to enrich from",
+                            },
+                        },
+                        required: ["id", "isni"],
+                    },
+                },
+                executor: this.enrichFromISNI.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_enrich_musicbrainz",
+                    description: "Enrich person data from MusicBrainz",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Person ID",
+                            },
+                            musicbrainz_id: {
+                                type: "string",
+                                description: "MusicBrainz artist ID",
+                            },
+                        },
+                        required: ["id", "musicbrainz_id"],
+                    },
+                },
+                executor: this.enrichFromMusicBrainz.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_people_get_full",
+                    description: "Get FULL context for a person in a single call — the person record plus all their " +
+                        "credited works (with work details), agreements, and identifier status (IPI, ISNI, " +
+                        "MusicBrainz, Wikidata, Discogs). Use this instead of making multiple separate tool " +
+                        "calls when you need to understand a person's complete catalog presence. " +
+                        "→ then: pica_enrich_person (fill gaps), pica_people_update (fix details)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Person ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getPersonFull.bind(this),
+            },
+        ];
+    }
+    /**
+     * List people
+     */
+    async listPeople(args) {
+        const limit = args.limit || 50;
+        const people = await this.pica.people.list({ limit });
+        // Apply search filter if provided
+        let filtered = people;
+        if (args.search) {
+            const searchLower = args.search.toLowerCase();
+            filtered = filtered.filter((person) => person.first_name?.toLowerCase().includes(searchLower) ||
+                person.last_name?.toLowerCase().includes(searchLower));
+        }
+        return formatStructuredList(filtered, "person", {
+            total: filtered.length,
+            limit,
+        });
+    }
+    /**
+     * Get person by ID
+     */
+    async getPerson(args) {
+        const person = await this.pica.people.get(args.id);
+        return formatAsText(person);
+    }
+    /**
+     * Create person
+     */
+    async createPerson(args) {
+        const person = await this.pica.people.create(args);
+        const hints = [
+            {
+                gap: "person_not_credited",
+                suggestion: "Add this person as a credit on a work (pica_credits_update)",
+                severity: "important",
+            },
+        ];
+        if (!person?.isni && !person?.musicbrainz_id) {
+            hints.push({
+                gap: "person_missing_identifiers",
+                suggestion: "Enrich with ISNI or MusicBrainz for royalty collection (pica_people_enrich_isni)",
+                severity: "important",
+            });
+        }
+        if (person?.email) {
+            hints.push({
+                gap: "person_not_invited",
+                suggestion: `Invite ${person.first_name || "them"} to PICA so they can manage their own profile (pica_collaborators_invite)`,
+                severity: "nice_to_have",
+            });
+        }
+        return formatSuccess("Person created successfully", person, hints);
+    }
+    /**
+     * Update person
+     */
+    async updatePerson(args) {
+        const { id, ...updates } = args;
+        const person = await this.pica.people.update(id, updates);
+        return formatSuccess("Person updated successfully", person);
+    }
+    /**
+     * Delete person
+     */
+    async deletePerson(args) {
+        await this.pica.people.delete(args.id);
+        return formatSuccess(`Person ${args.id} deleted successfully`);
+    }
+    /**
+     * Search people
+     */
+    async searchPeople(args) {
+        const limit = args.limit || 50;
+        const people = await this.pica.people.list({ limit });
+        const searchLower = args.query.toLowerCase();
+        const filtered = people.filter((person) => person.first_name?.toLowerCase().includes(searchLower) ||
+            person.last_name?.toLowerCase().includes(searchLower) ||
+            person.email?.toLowerCase().includes(searchLower));
+        return formatStructuredList(filtered, "person", {
+            query: args.query,
+            total: filtered.length,
+            limit,
+        });
+    }
+    /**
+     * Enrich from ISNI
+     */
+    async enrichFromISNI(args) {
+        const person = await this.pica.people.enrichFromISNI(args.id, args.isni);
+        return formatSuccess("Person enriched from ISNI successfully", person);
+    }
+    /**
+     * Enrich from MusicBrainz
+     */
+    async enrichFromMusicBrainz(args) {
+        const person = await this.pica.people.enrichFromMusicBrainz(args.id, args.musicbrainz_id);
+        return formatSuccess("Person enriched from MusicBrainz successfully", person);
+    }
+    /**
+     * Get full person context bundle
+     */
+    async getPersonFull(args) {
+        const result = await this.pica.entityContext.getPersonFull(args.id);
+        const data = result;
+        const person = data.person || {};
+        const fullName = person.name || args.id;
+        const workCount = data.creditedWorks?.length || 0;
+        const recordingCount = data.recordingCredits?.length || 0;
+        // identifiers is now an array of { type, value }
+        const identifiers = data.identifiers || [];
+        const idTypes = identifiers.map((i) => i.type);
+        return formatSuccess(`"${fullName}" — credited on ${workCount} work${workCount !== 1 ? "s" : ""}, ` +
+            `${recordingCount} recording${recordingCount !== 1 ? "s" : ""}. ` +
+            `Identifiers: ${idTypes.length > 0 ? idTypes.join(", ") : "none"}.`, result);
+    }
+}
+//# sourceMappingURL=people.js.map

package/dist/tools/people.js.map

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

package/dist/tools/pica-score.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PICA Score Tools - MCP tool for catalog health assessment
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class PicaScoreTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private getScore;
+}
+//# sourceMappingURL=pica-score.d.ts.map

package/dist/tools/pica-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pica-score.d.ts","sourceRoot":"","sources":["../../src/tools/pica-score.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;YAiB3D,QAAQ;CAIvB"}

package/dist/tools/pica-score.js

@@ -0,0 +1,30 @@
+/**
+ * PICA Score Tools - MCP tool for catalog health assessment
+ */
+import { formatAsText } from "../utils/formatting.js";
+export class PicaScoreTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_score_get",
+                    description: "Get the PICA Score — a composite legibility index (0-100) measuring catalog health across 4 pillars: income readiness, ownership clarity, asset completeness, and verification status. Returns grade (A-F), per-pillar breakdown, and actionable suggestions.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.getScore.bind(this),
+            },
+        ];
+    }
+    async getScore(_args) {
+        const score = await this.pica.picaScore.get();
+        return formatAsText(score);
+    }
+}
+//# sourceMappingURL=pica-score.js.map

package/dist/tools/pica-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pica-score.js","sourceRoot":"","sources":["../../src/tools/pica-score.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,OAAO,cAAc;IACjB,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,gBAAgB;oBACtB,WAAW,EACT,+PAA+P;oBACjQ,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,EAAE;qBACf;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;aACnC;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,KAA0B;QAC/C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QAC9C,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/tools/projects.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Projects Tools — group works into projects (albums, EPs, compilations, or any collection)
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class ProjectsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listProjects;
+    private getProject;
+    private createProject;
+    private updateProject;
+    private deleteProject;
+}
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.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,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;YA+G3D,YAAY;YAQZ,UAAU;YAKV,aAAa;YAMb,aAAa;YAMb,aAAa;CAI5B"}