@withpica/mcp-server 1.3.0

package/dist/tools/sync-placements.js

@@ -0,0 +1,431 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatList, formatSuccess } from "@withpica/mcp-utils";
+import { withBillingGate } from "@withpica/mcp-utils";
+export class SyncPlacementsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_sync_placements_query",
+                    description: "List sync placements for the org. Filters: work_id, status, verification_status, brand, production_company, person_id, recording_id, source_license_enquiry_id, min_fee, currency. Returns up to `limit` (default 50) with cursor support via `offset`.",
+                    workflows: ["sync-placement-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "Filter by work id",
+                            },
+                            status: {
+                                type: "string",
+                                enum: ["licensed", "aired", "expired", "renewed", "terminated"],
+                                description: "Filter by placement lifecycle status",
+                            },
+                            verification_status: {
+                                type: "string",
+                                enum: [
+                                    "unverified",
+                                    "self_attested",
+                                    "evidence_attached",
+                                    "operator_verified",
+                                    "disputed",
+                                ],
+                                description: "Filter by evidence verification state",
+                            },
+                            brand: {
+                                type: "string",
+                                description: "Filter by advertiser/brand name",
+                            },
+                            production_company: {
+                                type: "string",
+                                description: "Filter by production company name",
+                            },
+                            person_id: {
+                                type: "string",
+                                description: "Filter to placements where this person is a contact (music supervisor, etc.)",
+                            },
+                            recording_id: {
+                                type: "string",
+                                description: "Filter to placements that licensed this recording",
+                            },
+                            source_license_enquiry_id: {
+                                type: "string",
+                                description: "Filter to placements that originated from this license enquiry",
+                            },
+                            min_fee: {
+                                type: "number",
+                                description: "Minimum fee_amount (pre-pagination SQL filter)",
+                            },
+                            currency: {
+                                type: "string",
+                                description: "ISO-4217 currency code (e.g. USD, GBP)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results (default 50)",
+                            },
+                            offset: {
+                                type: "number",
+                                description: "Cursor offset",
+                            },
+                        },
+                    },
+                },
+                executor: this.query.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_sync_placements_inspect",
+                    description: "Get one sync placement by id, including all linked recordings, evidence sources, the underlying agreement, and party rows.",
+                    workflows: ["sync-placement-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Sync placement id",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.inspect.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_sync_placements_create",
+                    description: "Create a sync placement (atomic — placement + draft sync_license agreement + at least one agreement_party + recordings + evidence sources, all in one Postgres transaction). Requires at least one entry in `contacts[]`. Empty contacts rejects with structured MISSING_CONTACT (next_tool: pica_people_query). New people can be auto-created inline by passing `person_name` instead of `person_id`.",
+                    workflows: ["sync-placement-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "Work being licensed for the placement",
+                            },
+                            production_title: {
+                                type: "string",
+                                description: "The film/series/ad/game name the work is licensed into",
+                            },
+                            production_type: {
+                                type: "string",
+                                description: "Film, TV, advertising, trailer, video game, etc.",
+                            },
+                            brand: {
+                                type: "string",
+                                description: "Advertiser brand (for ad placements)",
+                            },
+                            production_company: {
+                                type: "string",
+                                description: "Production company name",
+                            },
+                            status: {
+                                type: "string",
+                                enum: ["licensed", "aired", "expired", "renewed", "terminated"],
+                                description: "Initial status (default 'licensed')",
+                            },
+                            fee_amount: {
+                                type: "number",
+                                description: "Total fee in minor units of fee_currency",
+                            },
+                            fee_currency: {
+                                type: "string",
+                                description: "ISO-4217 currency code",
+                            },
+                            use_start_date: {
+                                type: "string",
+                                description: "ISO-8601 date — first day of licensed use",
+                            },
+                            use_end_date: {
+                                type: "string",
+                                description: "ISO-8601 date — last day of licensed use",
+                            },
+                            territory: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "ISO-3166 country codes; ['WW'] = worldwide",
+                            },
+                            media_channels: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "tv, online, theatrical, social, in-game, in-store, etc.",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Free-text notes",
+                            },
+                            confidentiality_level: {
+                                type: "string",
+                                enum: ["public", "redacted_in_public_car", "private"],
+                                description: "Public-CAR redaction policy (default 'redacted_in_public_car')",
+                            },
+                            contacts: {
+                                type: "array",
+                                description: "At least one contact required. Pass `person_id` for an existing person OR `person_name` (+ optional email/company/position) to auto-create.",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        person_id: { type: "string" },
+                                        person_name: { type: "string" },
+                                        role: {
+                                            type: "string",
+                                            description: "music_supervisor | brand_marketing_lead | sync_agent | clearance_attorney | film_producer | director | …",
+                                        },
+                                        email: { type: "string" },
+                                        company: { type: "string" },
+                                        position: { type: "string" },
+                                        split_percentage: {
+                                            type: "number",
+                                            description: "Optional commission split (0–100)",
+                                        },
+                                    },
+                                    required: ["role"],
+                                },
+                                minItems: 1,
+                            },
+                            recordings: {
+                                type: "array",
+                                description: "Specific recordings being licensed under the placement (optional but typical for sync — one master per recording).",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        recording_id: { type: "string" },
+                                        role: {
+                                            type: "string",
+                                            description: "main_master | re_record | instrumental | edit | trailer_cut | …",
+                                        },
+                                        master_fee: { type: "number" },
+                                        master_share_licensed_pct: { type: "number" },
+                                        notes: { type: "string" },
+                                    },
+                                    required: ["recording_id", "role"],
+                                },
+                            },
+                            sources: {
+                                type: "array",
+                                description: "Evidence sources backing the placement. Auto-advances verification_status: any 'cue_sheet'/'invoice'/'agreement_pdf'/'email'/'screenshot'/'web'/'spreadsheet_import' → evidence_attached; 'user_attestation' only → self_attested; none → unverified.",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        url: { type: "string" },
+                                        kind: {
+                                            type: "string",
+                                            enum: [
+                                                "user_attestation",
+                                                "agreement_pdf",
+                                                "cue_sheet",
+                                                "invoice",
+                                                "email",
+                                                "screenshot",
+                                                "web",
+                                                "spreadsheet_import",
+                                            ],
+                                        },
+                                        agent_id: { type: "string" },
+                                        field_coverage: {
+                                            type: "array",
+                                            items: { type: "string" },
+                                        },
+                                        notes: { type: "string" },
+                                    },
+                                    required: ["url", "kind"],
+                                },
+                            },
+                        },
+                        required: ["work_id", "production_title", "contacts"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "sync placement creation", this.create.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_sync_placements_update",
+                    description: "Patch a sync placement. Most fields are unconditional; `verification_status` (when set to 'operator_verified' or 'disputed') and `confidentiality_level` are operator-gated and will throw OPERATOR_REQUIRED for customer agents — use a soft transition like status:'terminated' for self-service retirement instead. Status transitions follow the placement state machine; illegal transitions throw INVALID_TRANSITION (inspect first to see the current state).",
+                    workflows: ["sync-placement-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Sync placement id",
+                            },
+                            status: {
+                                type: "string",
+                                enum: ["licensed", "aired", "expired", "renewed", "terminated"],
+                                description: "Placement lifecycle status — transitions follow the sync_placement_status state machine; setting status:'terminated' is the customer-facing soft-delete path.",
+                            },
+                            verification_status: {
+                                type: "string",
+                                enum: [
+                                    "unverified",
+                                    "self_attested",
+                                    "evidence_attached",
+                                    "operator_verified",
+                                    "disputed",
+                                ],
+                                description: "Evidence verification state. Operator-only when set to 'operator_verified' or 'disputed'; other values throw OPERATOR_REQUIRED for customer agents.",
+                            },
+                            confidentiality_level: {
+                                type: "string",
+                                enum: ["public", "redacted_in_public_car", "private"],
+                                description: "Public-CAR redaction policy. Operator-only — changing this throws OPERATOR_REQUIRED for customer agents.",
+                            },
+                            production_title: {
+                                type: "string",
+                                description: "The film/series/ad/game name the work is licensed into",
+                            },
+                            production_type: {
+                                type: "string",
+                                description: "Film, TV, advertising, trailer, video game, etc.",
+                            },
+                            brand: {
+                                type: "string",
+                                description: "Advertiser brand (for ad placements)",
+                            },
+                            production_company: {
+                                type: "string",
+                                description: "Production company name",
+                            },
+                            fee_amount: {
+                                type: "number",
+                                description: "Total fee in minor units of fee_currency",
+                            },
+                            fee_currency: {
+                                type: "string",
+                                description: "ISO-4217 currency code",
+                            },
+                            use_start_date: {
+                                type: "string",
+                                description: "ISO-8601 date — first day of licensed use",
+                            },
+                            use_end_date: {
+                                type: "string",
+                                description: "ISO-8601 date — last day of licensed use",
+                            },
+                            territory: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "ISO-3166 country codes; ['WW'] = worldwide",
+                            },
+                            media_channels: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "tv, online, theatrical, social, in-game, in-store, etc.",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Free-text notes",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "sync placement update", this.update.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_sync_placements_delete",
+                    description: "Hard-delete a sync placement. Operator-only — customer agents will receive structured OPERATOR_REQUIRED. For self-service retirement, use pica_sync_placements_update with status:'terminated' (soft-delete). Two-step confirmation pattern: first call returns a confirmation_token; second call with the token executes the delete.",
+                    workflows: ["sync-placement-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Sync placement id",
+                            },
+                            confirmation_token: {
+                                type: "string",
+                                description: "Token from a prior call; required to actually execute the delete",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "sync placement deletion", this.delete.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_sync_placements_cite",
+                    description: "Attach an evidence source to a sync placement. Auto-recomputes verification_status — any non-attestation kind ('cue_sheet'/'invoice'/'agreement_pdf'/'email'/'screenshot'/'web'/'spreadsheet_import') advances unverified/self_attested → evidence_attached. operator_verified is sticky (only an explicit operator action exits it).",
+                    workflows: ["sync-placement-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Sync placement id",
+                            },
+                            url: {
+                                type: "string",
+                                description: "Evidence URL",
+                            },
+                            kind: {
+                                type: "string",
+                                enum: [
+                                    "user_attestation",
+                                    "agreement_pdf",
+                                    "cue_sheet",
+                                    "invoice",
+                                    "email",
+                                    "screenshot",
+                                    "web",
+                                    "spreadsheet_import",
+                                ],
+                                description: "Source kind. Any non-attestation kind advances verification_status to evidence_attached on first attach.",
+                            },
+                            agent_id: {
+                                type: "string",
+                                description: "Optional agent identity that supplied the source",
+                            },
+                            field_coverage: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Which placement fields this source attests to (used for evidence attribution in exports)",
+                            },
+                            notes: {
+                                type: "string",
+                                description: "Free-text notes",
+                            },
+                        },
+                        required: ["id", "url", "kind"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "sync placement evidence", this.cite.bind(this)),
+            },
+        ];
+    }
+    // ── executors ──────────────────────────────────────────────────────────
+    async query(args) {
+        const result = await this.pica.syncPlacements.list(args);
+        return formatList(result.data, { total: result.total });
+    }
+    async inspect(args) {
+        const placement = await this.pica.syncPlacements.get(args.id);
+        return formatAsText(placement);
+    }
+    async create(args) {
+        const placement = await this.pica.syncPlacements.create(args);
+        return formatSuccess("Sync placement created", placement);
+    }
+    async update(args) {
+        const { id, ...patch } = args;
+        const placement = await this.pica.syncPlacements.update(id, patch);
+        return formatSuccess("Sync placement updated", placement);
+    }
+    async delete(args) {
+        const { id, confirmation_token } = args;
+        await this.pica.syncPlacements.delete(id, { confirmation_token });
+        return formatSuccess(`Sync placement ${id} deleted`);
+    }
+    async cite(args) {
+        const { id, ...source } = args;
+        const result = await this.pica.syncPlacements.addSource(id, source);
+        return formatSuccess("Evidence attached to sync placement", result);
+    }
+}
+//# sourceMappingURL=sync-placements.js.map

package/dist/tools/sync-placements.js.map

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

package/dist/tools/team.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Team Tools — manage team members via MCP
+ *
+ * Backed by REST routes: /api/admin/team/*
+ * Supports listing, viewing, inviting, updating roles, and removing team members.
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class TeamTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listMembers;
+    private getMember;
+    private inviteMember;
+    private updateRole;
+    private removeMember;
+}
+//# sourceMappingURL=team.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../src/tools/team.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,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;YAkH3D,WAAW;YAQX,SAAS;YAKT,YAAY;YAYZ,UAAU;YAUV,YAAY;CAI3B"}

package/dist/tools/team.js

@@ -0,0 +1,144 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatStructuredList } from "@withpica/mcp-utils";
+export class TeamTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_team_list",
+                    description: "List all team members with their roles, status (pending/active), and permissions. Use to answer 'who is on my team?'",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.listMembers.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_team_get",
+                    description: "Get details of a specific team member by membership ID, including permissions, status, and activity.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Team membership ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getMember.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_team_invite",
+                    description: "Invite someone to join the team by email. Sends an invitation email. Optionally set their name and permissions.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            email: {
+                                type: "string",
+                                description: "Email address of the person to invite",
+                            },
+                            full_name: {
+                                type: "string",
+                                description: "Full name of the invitee (optional)",
+                            },
+                            permissions: {
+                                type: "object",
+                                description: "Permission flags for the team member (e.g. { can_edit_works: true, can_manage_team: false })",
+                            },
+                        },
+                        required: ["email"],
+                    },
+                },
+                executor: this.inviteMember.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_team_update_role",
+                    description: "Update a team member's role and/or permissions. Pass the membership ID and at least one of role or permissions.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Team membership ID (required).",
+                            },
+                            role: {
+                                type: "string",
+                                description: "Updated role name on team_memberships.role (e.g. 'admin', 'editor', 'viewer'). Optional — omit to leave unchanged.",
+                            },
+                            permissions: {
+                                type: "object",
+                                additionalProperties: true,
+                                description: "Updated permission flags (e.g. { can_edit_works: true, can_manage_team: false }). Optional — omit to leave unchanged.",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.updateRole.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_team_remove",
+                    description: "Remove a team member by membership ID. This revokes their access.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Team membership ID to remove",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.removeMember.bind(this),
+            },
+        ];
+    }
+    async listMembers(_args) {
+        const result = await this.pica.team.list();
+        const members = Array.isArray(result)
+            ? result
+            : (result?.data ?? result?.members ?? []);
+        return formatStructuredList(members, "team member");
+    }
+    async getMember(args) {
+        const member = await this.pica.team.get(args.id);
+        return formatSuccess("Team member retrieved", member?.data ?? member);
+    }
+    async inviteMember(args) {
+        const payload = { email: args.email };
+        if (args.full_name)
+            payload.full_name = args.full_name;
+        if (args.permissions)
+            payload.permissions = args.permissions;
+        const result = await this.pica.team.invite(payload);
+        return formatSuccess(`Invitation sent to ${args.email}`, result?.data ?? result);
+    }
+    async updateRole(args) {
+        const result = await this.pica.team.update(args.id, {
+            permissions: args.permissions,
+        });
+        return formatSuccess(`Permissions updated for membership ${args.id}`, result?.data ?? result);
+    }
+    async removeMember(args) {
+        await this.pica.team.remove(args.id);
+        return formatSuccess(`Team member ${args.id} removed`);
+    }
+}
+//# sourceMappingURL=team.js.map

package/dist/tools/team.js.map

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

package/dist/tools/telegram.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Telegram Tools — MCP tools for user notification via Telegram
+ *
+ * Lets AI agents check if the user has Telegram connected and send them
+ * notifications for long-running tasks. Agents should check status first,
+ * then promise "I'll ping you on Telegram when done" if connected.
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class TelegramTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private getStatus;
+    private notifyUser;
+    private connect;
+}
+//# sourceMappingURL=telegram.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/tools/telegram.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;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;YAiE3D,SAAS;YAwBT,UAAU;YAgCV,OAAO;CAyCtB"}