@withpica/mcp-server 1.3.0

package/dist/tools/signup.js

@@ -0,0 +1,266 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/**
+ * Signup Tools — `pica_signup_start` (ADR-211 Phase 1).
+ *
+ * The single MCP-discoverable signup verb. Available unauthenticated on
+ * BOTH transports (stdio binary's lobby + HTTP `/api/mcp` anonymous mode)
+ * per ADR-211 § Primitive A (amended 2026-04-30 to expose alongside
+ * `pica_sign_in` / `pica_sign_out` rather than replace them in Phase 1).
+ *
+ * Mints nothing locally — every invocation calls the public backend
+ * endpoint `POST /api/public/onboarding/signup-start`. The signing secret
+ * (`ONBOARDING_TOKEN_SECRET`) lives only on the backend; customer-
+ * distributed `npx @withpica/mcp-server` binaries can never see it. Same
+ * pattern that `pica_sign_in` (auth.ts) uses to call the public
+ * `/api/public/mcp-auth/authorize` magic-link endpoint.
+ *
+ * Returns the JWT-bound URL via:
+ *   - `resource_link` (universal floor — every MCP client can render this)
+ *   - capability-gated `elicitation/create url` (mode: "url"; for clients
+ *     advertising `capabilities.elicitation.url`, server-issued consent
+ *     prompt to open the link in-line). See ADR-200 + `pica_upload`.
+ *
+ * Construction takes the API base URL + transport + optional DCR
+ * client_id. The stdio binary stamps `transport: "stdio"`; the HTTP
+ * carve-out in `app/api/mcp/route.ts` stamps `transport: "http"` and
+ * passes `client_id` from the OAuth-protected-resource discovery context
+ * when one is present.
+ */
+import { randomUUID } from "node:crypto";
+import { clientSupportsUrlElicitation } from "@withpica/mcp-utils";
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+export class SignupTools {
+    apiUrl;
+    transport;
+    clientId;
+    constructor(config) {
+        if (!config.apiUrl) {
+            throw new Error("SignupTools requires apiUrl");
+        }
+        if (config.transport !== "stdio" && config.transport !== "http") {
+            throw new Error(`SignupTools.transport must be "stdio" or "http" (got: ${config.transport})`);
+        }
+        if (config.transport === "stdio" && config.clientId) {
+            // stdio has no DCR client identifier. Constructor enforces the
+            // invariant locally so the public endpoint never sees a confused
+            // pairing in the first place.
+            throw new Error("clientId must be null for stdio transport");
+        }
+        this.apiUrl = config.apiUrl.replace(/\/+$/, "");
+        this.transport = config.transport;
+        this.clientId = config.clientId ?? null;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_signup_start",
+                    description: "Sign up for withPICA from inside the agent, without leaving the chat. " +
+                        "Use this when the user wants to create a new withPICA account / catalog " +
+                        "and you're talking to them through an unauthenticated MCP connection " +
+                        "(stdio without an API key, or HTTP without a Bearer token). The tool " +
+                        "mints a single-use signup link valid for 15 minutes — surface the URL " +
+                        "to the user as a clickable resource_link. The link opens a page that " +
+                        "verifies their email by magic-link, creates their organisation, starts " +
+                        "the 14-day free trial, and (for stdio) shows a connection key to paste " +
+                        "into Claude Desktop's MCP config or (for HTTP) resumes the OAuth flow. " +
+                        "For existing users, prefer pica_sign_in.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            email: {
+                                type: "string",
+                                description: "The user's email address. The signup link is sent to this " +
+                                    "inbox; the user clicks it to verify ownership before any " +
+                                    "account is created. Required.",
+                            },
+                            org_name: {
+                                type: "string",
+                                description: "Optional human name for the user's catalog/organisation. " +
+                                    "Defaults to '<email-localpart>'s catalog' if omitted. " +
+                                    "Editable later in settings.",
+                            },
+                            purpose: {
+                                type: "string",
+                                description: "Optional free-text — what the user is trying to do with " +
+                                    "PICA, captured for product analytics (e.g. 'managing my " +
+                                    "first album credits', 'exporting royalty statements'). " +
+                                    "Not surfaced to the user.",
+                            },
+                        },
+                        required: ["email"],
+                    },
+                },
+                executor: this.signupStart.bind(this),
+            },
+        ];
+    }
+    async signupStart(args, ctx) {
+        const email = typeof args.email === "string" ? args.email.trim().toLowerCase() : "";
+        if (!email || !EMAIL_REGEX.test(email)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "that doesn't look like an email address — please ask the user to confirm and try again.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const orgName = typeof args.org_name === "string" && args.org_name.trim().length > 0
+            ? args.org_name.trim()
+            : undefined;
+        const purpose = typeof args.purpose === "string" && args.purpose.trim().length > 0
+            ? args.purpose.trim()
+            : undefined;
+        // The public endpoint is unauthenticated — same fetch shape as
+        // pica_sign_in's call to /api/public/mcp-auth/authorize.
+        const endpoint = `${this.apiUrl}/public/onboarding/signup-start`;
+        let response;
+        try {
+            response = await fetch(endpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    email,
+                    ...(orgName ? { org_name: orgName } : {}),
+                    ...(purpose ? { purpose } : {}),
+                    transport: this.transport,
+                    ...(this.clientId ? { client_id: this.clientId } : {}),
+                }),
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "network error";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `couldn't reach withPICA to mint your signup link (${message}). check your internet connection and try again.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (response.status === 429) {
+            const retryAfter = response.headers.get("Retry-After") ?? "a few minutes";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `too many signup attempts — please wait ${retryAfter} seconds before trying again. if the user just requested a link, ask them to check their inbox first.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!response.ok) {
+            let detail = "unknown error";
+            try {
+                const body = (await response.json());
+                if (typeof body.error === "string")
+                    detail = body.error;
+            }
+            catch {
+                // body wasn't JSON — fall back to status text
+                detail = response.statusText || detail;
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `couldn't mint your signup link: ${detail}. please try again or report this if it keeps happening.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        let body;
+        try {
+            body = (await response.json());
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "the signup endpoint returned a malformed response. please try again.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (!body.url || !body.expires_at) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "the signup endpoint returned an incomplete response. please try again.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const url = body.url;
+        const expiresAt = body.expires_at;
+        const textSummary = `signup link minted for ${email}. surface this URL to the user — they should click it to verify ownership of the email, ` +
+            `pick an organisation name, and start their 14-day trial. the link expires at ${expiresAt} (15 minutes from now). ` +
+            (this.transport === "stdio"
+                ? "after they finish signup the page will show a connection key to paste into Claude Desktop's MCP config; they'll then need to reconnect the PICA MCP server."
+                : "after they finish signup the OAuth flow resumes automatically.");
+        const resourceLink = {
+            type: "resource_link",
+            uri: url,
+            name: "Sign up for withPICA",
+            description: "Open this link to verify your email, create your catalog, and start a 14-day trial.",
+            mimeType: "text/html",
+        };
+        const baseContent = [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    text_summary: textSummary,
+                    signup_url: url,
+                    expires_at: expiresAt,
+                    surface: body.surface ?? "onboarding",
+                }),
+            },
+            resourceLink,
+        ];
+        // Capability-gated `elicitation/create url` — clients advertising
+        // `capabilities.elicitation.url` get a server-issued consent prompt
+        // to open the link in-line. Without the gate, calling elicitInput
+        // against a non-supporter throws synchronously per
+        // `feedback_mcp_sdk_capability_gates_elicitation.md`.
+        if (clientSupportsUrlElicitation(ctx?.server)) {
+            try {
+                await ctx.server.elicitInput({
+                    mode: "url",
+                    url,
+                    elicitationId: `pica-signup-${randomUUID()}`,
+                    message: `Open this URL to finish signing up for withPICA. Expires at ${expiresAt}.`,
+                }, { timeout: 60_000 });
+            }
+            catch {
+                // user declined / cancelled / timed out — `resource_link` remains
+                // usable so we degrade silently rather than fail the tool.
+            }
+        }
+        return {
+            content: baseContent,
+            structuredContent: {
+                kind: "pica.card.signup_start",
+                version: 1,
+                data: {
+                    signup_url: url,
+                    expires_at: expiresAt,
+                    email,
+                    transport: this.transport,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=signup.js.map

package/dist/tools/signup.js.map

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

package/dist/tools/split-sheets.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Split Sheets & Recording Splits Tools
+ * MCP tools for managing publishing split sheets and master recording ownership splits
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class SplitSheetsTools {
+    private pica;
+    constructor(pica: PicaClient);
+    /**
+     * Get all split sheet and recording split tools
+     */
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private sendSplitSheet;
+    private listSplitSheets;
+    private generateSplitSheet;
+    private getSplitSheet;
+    private listRecordingSplits;
+    private createRecordingSplit;
+    private verifyRecordingSplit;
+}
+//# sourceMappingURL=split-sheets.d.ts.map

package/dist/tools/split-sheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-sheets.d.ts","sourceRoot":"","sources":["../../src/tools/split-sheets.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,YAAY,EAGb,MAAM,YAAY,CAAC;AAUpB,qBAAa,gBAAgB;IAC3B,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;YA2K3D,cAAc;YAmGd,eAAe;YAWf,kBAAkB;YAOlB,aAAa;YAUb,mBAAmB;YAWnB,oBAAoB;YAuCpB,oBAAoB;CASnC"}

package/dist/tools/split-sheets.js

@@ -0,0 +1,309 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { elicitBulkConfirmation, formatAsText, formatSuccess, formatStructuredList, RECORDING_SPLITS_WRITE_PROPERTIES, RECORDING_SPLITS_CREATE_REQUIRED, } from "@withpica/mcp-utils";
+export class SplitSheetsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    /**
+     * Get all split sheet and recording split tools
+     */
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_split_sheet_send",
+                    description: "Send a split sheet to all credited writers on a work for review and signature. " +
+                        "Notifies each writer via in-app notification, Telegram (if connected), and email. " +
+                        "The split sheet must already be generated. Writers who are not PICA users get " +
+                        "a collaboration invite email instead.",
+                    workflows: ["split-sheet-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID the split sheet belongs to",
+                            },
+                            split_sheet_id: {
+                                type: "string",
+                                description: "The split sheet ID to send",
+                            },
+                            message: {
+                                type: "string",
+                                description: "Optional custom message to include (default: 'please review and sign the split sheet')",
+                            },
+                        },
+                        required: ["work_id", "split_sheet_id"],
+                    },
+                },
+                executor: this.sendSplitSheet.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_split_sheet_list",
+                    description: "List split sheets for a work. Split sheets document how publishing " +
+                        "royalties are divided among writers and publishers for a composition.",
+                    workflows: ["split-sheet-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to list split sheets for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.listSplitSheets.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_split_sheet_generate",
+                    description: "Generate a split sheet from a work's credits. This takes the existing " +
+                        "writer credits on a work and creates a formal split sheet document. " +
+                        "Credits must total 100% before generating.",
+                    workflows: ["split-sheet-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID to generate a split sheet for",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                },
+                executor: this.generateSplitSheet.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_split_sheet_get",
+                    description: "Get a specific split sheet with its full details including " +
+                        "individual writer shares and signature status.",
+                    workflows: ["split-sheet-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "The work ID the split sheet belongs to",
+                            },
+                            split_sheet_id: {
+                                type: "string",
+                                description: "The split sheet ID",
+                            },
+                        },
+                        required: ["work_id", "split_sheet_id"],
+                    },
+                },
+                executor: this.getSplitSheet.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_recording_splits_list",
+                    description: "List ownership splits for a recording. These represent master rights " +
+                        "ownership — who owns what percentage of the recorded performance " +
+                        "(as opposed to the underlying composition).",
+                    workflows: ["recording-splits-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            recording_id: {
+                                type: "string",
+                                description: "The recording ID to list splits for",
+                            },
+                        },
+                        required: ["recording_id"],
+                    },
+                },
+                executor: this.listRecordingSplits.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_recording_splits_create",
+                    description: "Set an ownership split on a recording. Assigns a percentage of master " +
+                        "rights ownership to a person or entity for this recording.",
+                    workflows: ["recording-splits-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            ...RECORDING_SPLITS_WRITE_PROPERTIES,
+                            dry_run: {
+                                type: "boolean",
+                                description: "When true, returns { dry_run: true, would_affect, sample } without persisting the split. Use to preview what the row would look like before committing — split percentages on a recording can shift downstream payment and credit-gating outcomes.",
+                            },
+                        },
+                        required: [...RECORDING_SPLITS_CREATE_REQUIRED],
+                    },
+                    previewMode: "dry_run",
+                },
+                executor: this.createRecordingSplit.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_recording_splits_verify",
+                    description: "Verify a recording split. Marks a specific ownership split as " +
+                        "confirmed and agreed upon by the relevant parties.",
+                    workflows: ["recording-splits-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            recording_id: {
+                                type: "string",
+                                description: "The recording ID",
+                            },
+                            split_id: {
+                                type: "string",
+                                description: "The split ID to verify",
+                            },
+                        },
+                        required: ["recording_id", "split_id"],
+                    },
+                },
+                executor: this.verifyRecordingSplit.bind(this),
+            },
+        ];
+    }
+    // ── Send Split Sheet ─────────────────────────────────────────────────
+    async sendSplitSheet(args) {
+        // 1. Verify split sheet exists
+        const sheet = await this.pica.splitSheets.get(args.work_id, args.split_sheet_id);
+        if (!sheet) {
+            return formatAsText({
+                sent: false,
+                error: "Split sheet not found",
+            });
+        }
+        // 2. Get all credits on this work to find writers
+        const creditsResult = await this.pica.credits.listForWork(args.work_id);
+        const writers = Array.isArray(creditsResult)
+            ? creditsResult
+            : creditsResult?.data || [];
+        if (writers.length === 0) {
+            return formatAsText({
+                sent: false,
+                error: "No credits found on this work. Add writers before sending the split sheet.",
+            });
+        }
+        // 3. Notify each writer
+        const message = args.message?.trim() ||
+            "please review and sign the split sheet for this work";
+        const results = [];
+        for (const credit of writers) {
+            if (!credit.person_id)
+                continue;
+            try {
+                const result = await this.pica.notifications.sendToPerson({
+                    person_id: credit.person_id,
+                    message: `${message} — your share: ${credit.splits ?? "?"}%`,
+                    work_id: args.work_id,
+                    notification_type: "split_sheet_review",
+                });
+                const data = result.data || result;
+                results.push({
+                    person_id: credit.person_id,
+                    name: data.person_name || credit.person_name || "Unknown",
+                    delivered: data.delivered,
+                    channels: data.channels,
+                    reason: data.reason,
+                });
+            }
+            catch {
+                results.push({
+                    person_id: credit.person_id,
+                    name: credit.person_name || "Unknown",
+                    delivered: false,
+                    reason: "notification_failed",
+                });
+            }
+        }
+        const delivered = results.filter((r) => r.delivered);
+        const notPicaUsers = results.filter((r) => r.reason === "not_a_pica_user");
+        const failed = results.filter((r) => !r.delivered && r.reason !== "not_a_pica_user");
+        const summary = [
+            `Split sheet sent to ${delivered.length}/${results.length} writers`,
+            delivered.length > 0
+                ? `Delivered: ${delivered.map((r) => r.name).join(", ")}`
+                : null,
+            notPicaUsers.length > 0
+                ? `Not PICA users (use pica_collaborators_invite): ${notPicaUsers.map((r) => r.name).join(", ")}`
+                : null,
+            failed.length > 0
+                ? `Failed: ${failed.map((r) => r.name).join(", ")}`
+                : null,
+        ]
+            .filter(Boolean)
+            .join(". ");
+        return formatSuccess(summary, {
+            split_sheet_id: args.split_sheet_id,
+            work_id: args.work_id,
+            results,
+        });
+    }
+    // ── Split Sheet Methods ──────────────────────────────────────────────
+    async listSplitSheets(args) {
+        const sheets = await this.pica.splitSheets.listForWork(args.work_id);
+        const data = Array.isArray(sheets) ? sheets : (sheets?.data ?? [sheets]);
+        return formatStructuredList(data, "split_sheet", {
+            work_id: args.work_id,
+            total: data.length,
+        });
+    }
+    async generateSplitSheet(args) {
+        const sheet = await this.pica.splitSheets.generate(args.work_id);
+        return formatSuccess("Split sheet generated successfully", sheet);
+    }
+    async getSplitSheet(args) {
+        const sheet = await this.pica.splitSheets.get(args.work_id, args.split_sheet_id);
+        return formatAsText(sheet);
+    }
+    // ── Recording Split Methods ──────────────────────────────────────────
+    async listRecordingSplits(args) {
+        const splits = await this.pica.recordingSplits.list(args.recording_id);
+        const data = Array.isArray(splits) ? splits : (splits?.data ?? [splits]);
+        return formatStructuredList(data, "recording_split", {
+            recording_id: args.recording_id,
+            total: data.length,
+        });
+    }
+    async createRecordingSplit(args, ctx) {
+        const { recording_id, dry_run, ...data } = args;
+        // ADR-199 Stream 5b — dry_run preview before mutation. Validation
+        // would otherwise be enforced by the route, but for a single-row
+        // create the dry_run echo of what would land is the most useful
+        // preview shape (no separate would_affect / target_count needed —
+        // the operation creates exactly one row).
+        if (dry_run === true) {
+            return formatSuccess(`Dry run — would create a recording split on ${recording_id}`, {
+                dry_run: true,
+                would_affect: [recording_id],
+                sample: { recording_id, ...data },
+                target_count: 1,
+            });
+        }
+        // ADR-200 Phase 1 — Class D form-confirmation gate. Recording
+        // splits drive royalty payouts; agent-issued writes need explicit
+        // user confirmation when the client supports the form primitive.
+        const role = data.role ?? "owner";
+        const percentage = data.percentage;
+        const gate = await elicitBulkConfirmation({
+            server: ctx?.server,
+            args,
+            action: "Create recording split",
+            impactSummary: `${role} ${percentage != null ? percentage + "%" : "split"} on recording ${recording_id}`,
+            warning: "Recording splits drive master royalty payouts and downstream credit gating. Confirm the percentage is correct before proceeding.",
+        });
+        if (gate.kind === "abort")
+            return gate.result;
+        const split = await this.pica.recordingSplits.create(recording_id, data);
+        return formatSuccess("Recording split created successfully", split);
+    }
+    async verifyRecordingSplit(args) {
+        const result = await this.pica.recordingSplits.verify(args.recording_id, args.split_id);
+        return formatSuccess("Recording split verified successfully", result);
+    }
+}
+//# sourceMappingURL=split-sheets.js.map

package/dist/tools/split-sheets.js.map

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

package/dist/tools/storage-config.d.ts

@@ -0,0 +1,13 @@
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class StorageConfigTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private configureStart;
+    private disconnect;
+}
+//# sourceMappingURL=storage-config.d.ts.map

package/dist/tools/storage-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-config.d.ts","sourceRoot":"","sources":["../../src/tools/storage-config.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EACL,cAAc,EACd,YAAY,EAGb,MAAM,YAAY,CAAC;AAiBpB,qBAAa,kBAAkB;IAC7B,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;YA6E3D,cAAc;YA4Hd,UAAU;CAgDzB"}