@withpica/mcp-server 2.1.0

package/dist/tools/assets.js

@@ -0,0 +1,220 @@
+/**
+ * Physical Assets Tools - MCP tools for managing equipment, instruments, and studio gear
+ */
+import { formatAsText, formatSuccess, formatStructuredList, } from "../utils/formatting.js";
+export class AssetsTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_physical_assets_list",
+                    description: "List physical assets — equipment, instruments, studio gear. Filter by category.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            category: {
+                                type: "string",
+                                description: "Filter by category (e.g. instrument, equipment, studio, software)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listAssets.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_physical_assets_get",
+                    description: "Get details of a specific physical asset including current valuation.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Asset ID" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getAsset.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_physical_assets_create",
+                    description: "Register a new physical asset — equipment, instrument, or studio gear. Track for insurance and valuation.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            name: {
+                                type: "string",
+                                description: "Asset name (e.g. 'Fender Stratocaster 1962')",
+                            },
+                            category: {
+                                type: "string",
+                                description: "Category: instrument, equipment, studio, software, other",
+                            },
+                            description: {
+                                type: "string",
+                                description: "Description of the asset",
+                            },
+                            serial_number: {
+                                type: "string",
+                                description: "Serial number if available",
+                            },
+                            purchase_price: {
+                                type: "number",
+                                description: "Original purchase price",
+                            },
+                            purchase_date: {
+                                type: "string",
+                                description: "Purchase date (YYYY-MM-DD)",
+                            },
+                            current_value: {
+                                type: "number",
+                                description: "Estimated current value",
+                            },
+                            currency: {
+                                type: "string",
+                                description: "Currency code (default: GBP)",
+                            },
+                            condition: {
+                                type: "string",
+                                description: "Condition: excellent, good, fair, poor",
+                            },
+                            location: {
+                                type: "string",
+                                description: "Where the asset is stored",
+                            },
+                            insured: {
+                                type: "boolean",
+                                description: "Whether the asset is insured",
+                            },
+                        },
+                        required: ["name"],
+                        additionalProperties: true,
+                    },
+                },
+                executor: this.createAsset.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_physical_assets_update",
+                    description: "Update a physical asset — change valuation, condition, location, insurance status.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Asset ID" },
+                        },
+                        required: ["id"],
+                        additionalProperties: true,
+                    },
+                },
+                executor: this.updateAsset.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_physical_assets_delete",
+                    description: "Delete a physical asset by ID.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Asset ID" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.deleteAsset.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_physical_assets_stats",
+                    description: "Get summary statistics for all physical assets — total value, count by category, insurance coverage.",
+                    inputSchema: { type: "object", properties: {} },
+                },
+                executor: this.assetStats.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_physical_assets_valuations",
+                    description: "Get the valuation history for a physical asset — tracks value changes over time.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Asset ID" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.assetValuations.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_physical_assets_market_check",
+                    description: "Check market value for a physical asset — compares current valuation against market data.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Asset ID" },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.assetMarketCheck.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_physical_assets_export",
+                    description: "Export all physical assets as a downloadable report.",
+                    inputSchema: { type: "object", properties: {} },
+                },
+                executor: this.assetExport.bind(this),
+            },
+        ];
+    }
+    async listAssets(args) {
+        const assets = await this.pica.assets.list({
+            category: args.category,
+            limit: args.limit,
+        });
+        return formatStructuredList(Array.isArray(assets) ? assets : assets?.data || [], "asset");
+    }
+    async getAsset(args) {
+        const asset = await this.pica.assets.get(args.id);
+        return formatSuccess(`Asset: ${asset?.name || args.id}`, asset);
+    }
+    async createAsset(args) {
+        const asset = await this.pica.assets.create(args);
+        return formatSuccess("Physical asset registered successfully", asset);
+    }
+    async updateAsset(args) {
+        const { id, ...updates } = args;
+        const asset = await this.pica.assets.update(id, updates);
+        return formatSuccess("Asset updated successfully", asset);
+    }
+    async deleteAsset(args) {
+        await this.pica.assets.delete(args.id);
+        return formatSuccess("Asset deleted successfully");
+    }
+    async assetStats(_args) {
+        const stats = await this.pica.assets.stats();
+        return formatAsText(stats);
+    }
+    async assetValuations(args) {
+        const valuations = await this.pica.assets.valuations(args.id);
+        return formatAsText(valuations);
+    }
+    async assetMarketCheck(args) {
+        const result = await this.pica.assets.marketCheck(args.id);
+        return formatAsText(result);
+    }
+    async assetExport(_args) {
+        const result = await this.pica.assets.exportAll();
+        return formatAsText(result);
+    }
+}
+//# sourceMappingURL=assets.js.map

package/dist/tools/assets.js.map

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

package/dist/tools/audio-files.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Audio Files Tools - MCP tools for managing audio files and analysis
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class AudioFilesTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private listAudioFiles;
+    private getAudioFile;
+    private analyzeAudioFile;
+    private getAudioStatus;
+    private presignedUpload;
+    private completeUpload;
+    private identifyAudioFile;
+}
+//# sourceMappingURL=audio-files.d.ts.map

package/dist/tools/audio-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-files.d.ts","sourceRoot":"","sources":["../../src/tools/audio-files.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAStE,qBAAa,eAAe;IAC1B,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;YAyR3D,cAAc;YAUd,YAAY;YAKZ,gBAAgB;YAchB,cAAc;YAKd,eAAe;YAyBf,cAAc;YAgDd,iBAAiB;CA0BhC"}

package/dist/tools/audio-files.js

@@ -0,0 +1,358 @@
+/**
+ * Audio Files Tools - MCP tools for managing audio files and analysis
+ */
+import { formatAsText, formatList, formatSuccess, } from "../utils/formatting.js";
+import { withCreditGate } from "../utils/credit-gate.js";
+export class AudioFilesTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_audio_list",
+                    description: "List audio files in the catalog. Can filter by work, file type, or analysis status.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "Filter by work ID to get all audio files for a specific work",
+                            },
+                            file_type: {
+                                type: "string",
+                                description: "Filter by file type",
+                                enum: ["master", "instrumental", "stem", "demo", "version"],
+                            },
+                            unprocessed: {
+                                type: "boolean",
+                                description: "Set true to get only files without audio analysis (no BPM/key detection yet)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Maximum results to return (default: 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.listAudioFiles.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_audio_get",
+                    description: "Get a single audio file with full details including analysis data (BPM, key, energy, valence, mood tags, duration).",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Audio file ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getAudioFile.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_audio_analyze",
+                    description: "Trigger audio analysis on an audio file. Two analysis types available (1 credit each):\n" +
+                        "• Audio features (BPM, key, energy, valence, mood, duration) — via Librosa on Railway\n" +
+                        "• Lyrics transcription (speech-to-text + language detection) — via Groq Whisper on Railway\n\n" +
+                        "Both are enabled by default. Analysis runs asynchronously — use pica_audio_status to check progress. " +
+                        "Transcribed lyrics are saved to the transcriptions table and can be copied to the work's lyrics field. " +
+                        "→ then: pica_audio_status (check progress), pica_search_for_sync (find sync-ready works)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Audio file ID to analyze",
+                            },
+                            force: {
+                                type: "boolean",
+                                description: "Force re-analysis even if the file was already analyzed",
+                            },
+                            enable_audio: {
+                                type: "boolean",
+                                description: "Enable audio feature extraction (BPM, key, energy). Default: true. Costs 1 credit.",
+                            },
+                            enable_lyrics: {
+                                type: "boolean",
+                                description: "Enable lyrics transcription via Whisper. Default: true. Costs 1 credit.",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: withCreditGate(this.pica, "analysis_audio", "audio analysis", this.analyzeAudioFile.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_audio_status",
+                    description: "Check the analysis status of an audio file: processing, completed, failed, or not_started.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Audio file ID",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: this.getAudioStatus.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_audio_presigned_upload",
+                    description: "Generate a signed URL for uploading an audio file directly to storage. Returns an upload URL and upload ID. After uploading the file via HTTP PUT to the returned URL, call pica_audio_complete_upload to finalize. Supported formats: WAV, MP3, FLAC, AIFF, OGG, WebM. Max size: 800MB. " +
+                        "→ then: pica_audio_complete_upload (finalize upload), pica_audio_analyze (extract BPM, key, mood)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            filename: {
+                                type: "string",
+                                description: "Original filename with extension (e.g. 'my-song.wav')",
+                            },
+                            content_type: {
+                                type: "string",
+                                description: "MIME type of the audio file (e.g. 'audio/wav', 'audio/mpeg', 'audio/flac')",
+                                enum: [
+                                    "audio/wav",
+                                    "audio/x-wav",
+                                    "audio/mpeg",
+                                    "audio/mp3",
+                                    "audio/flac",
+                                    "audio/x-flac",
+                                    "audio/aiff",
+                                    "audio/x-aiff",
+                                    "audio/ogg",
+                                    "audio/webm",
+                                ],
+                            },
+                            file_size: {
+                                type: "number",
+                                description: "File size in bytes",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Optional work ID to link the audio file to. If provided, a recording will be auto-created for master files.",
+                            },
+                            title: {
+                                type: "string",
+                                description: "Optional title for the audio file. Defaults to filename without extension.",
+                            },
+                            file_type: {
+                                type: "string",
+                                description: "Type of audio file (default: 'master')",
+                                enum: ["master", "instrumental", "stem", "demo", "version"],
+                            },
+                        },
+                        required: ["filename", "content_type", "file_size"],
+                    },
+                },
+                executor: this.presignedUpload.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_audio_complete_upload",
+                    description: "Finalize an audio file upload after the file has been PUT to the signed URL from pica_audio_presigned_upload. Creates the database record and optionally links to a work/recording. For master files linked to a work, a recording is auto-created if none exists. " +
+                        "→ then: pica_audio_analyze (extract BPM, key, mood), pica_audio_identify (fingerprint match via ACRCloud)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            upload_id: {
+                                type: "string",
+                                description: "The uploadId returned from pica_audio_presigned_upload",
+                            },
+                            key: {
+                                type: "string",
+                                description: "The storage key returned from pica_audio_presigned_upload",
+                            },
+                            bucket: {
+                                type: "string",
+                                description: "The bucket returned from pica_audio_presigned_upload",
+                            },
+                            filename: {
+                                type: "string",
+                                description: "Original filename",
+                            },
+                            content_type: {
+                                type: "string",
+                                description: "MIME type of the uploaded file",
+                            },
+                            file_size: {
+                                type: "number",
+                                description: "File size in bytes",
+                            },
+                            work_id: {
+                                type: "string",
+                                description: "Optional work ID to link the audio file to",
+                            },
+                            title: {
+                                type: "string",
+                                description: "Optional title for the audio file",
+                            },
+                            file_type: {
+                                type: "string",
+                                description: "Type of audio file (default: 'master')",
+                                enum: ["master", "instrumental", "stem", "demo", "version"],
+                            },
+                            stem_label: {
+                                type: "string",
+                                description: "Label for stem files (e.g. 'vocals', 'drums', 'bass')",
+                            },
+                            version_label: {
+                                type: "string",
+                                description: "Label for version files (e.g. 'radio edit', 'extended mix')",
+                            },
+                            recording_id: {
+                                type: "string",
+                                description: "Link to an existing recording ID instead of auto-creating one",
+                            },
+                            classification: {
+                                type: "string",
+                                description: "Audio classification (e.g. 'original', 'remix', 'cover', 'live')",
+                            },
+                        },
+                        required: [
+                            "upload_id",
+                            "key",
+                            "bucket",
+                            "filename",
+                            "content_type",
+                            "file_size",
+                        ],
+                    },
+                },
+                executor: this.completeUpload.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_audio_identify",
+                    description: "Identify a track using ACRCloud audio fingerprinting. Returns matched metadata (title, artist, album, ISRC, label) with confidence score. If matched, metadata is automatically propagated to the linked work. Costs 3 pica credits on match, 1 on no match. Check pica_credits_balance first.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            id: {
+                                type: "string",
+                                description: "Audio file ID to identify",
+                            },
+                            force: {
+                                type: "boolean",
+                                description: "Force re-identification even if already matched",
+                            },
+                        },
+                        required: ["id"],
+                    },
+                },
+                executor: withCreditGate(this.pica, "analysis_audio_identify", "audio identification", this.identifyAudioFile.bind(this)),
+            },
+        ];
+    }
+    async listAudioFiles(args) {
+        const files = await this.pica.audioFiles.list({
+            work_id: args.work_id,
+            file_type: args.file_type,
+            unprocessed: args.unprocessed,
+            limit: args.limit,
+        });
+        return formatList(files, { total: files.length });
+    }
+    async getAudioFile(args) {
+        const file = await this.pica.audioFiles.get(args.id);
+        return formatAsText(file);
+    }
+    async analyzeAudioFile(args) {
+        const result = await this.pica.audioFiles.analyze(args.id, {
+            forceReAnalyze: args.force,
+            enableAudio: args.enable_audio,
+            enableLyrics: args.enable_lyrics,
+        });
+        return formatSuccess(result.message || "Analysis triggered", result.features);
+    }
+    async getAudioStatus(args) {
+        const status = await this.pica.audioFiles.getStatus(args.id);
+        return formatAsText(status);
+    }
+    async presignedUpload(args) {
+        const result = await this.pica.audioFiles.presignedUpload({
+            filename: args.filename,
+            contentType: args.content_type,
+            fileSize: args.file_size,
+            workId: args.work_id,
+            title: args.title,
+            fileType: args.file_type,
+        });
+        return formatSuccess(`Upload URL generated for "${args.filename}". PUT the file to the uploadUrl, then call pica_audio_complete_upload with the uploadId, key, bucket, and metadata to finalize.`, {
+            uploadUrl: result.uploadUrl,
+            uploadId: result.uploadId,
+            key: result.key,
+            bucket: result.bucket,
+            expiresAt: result.expiresAt,
+            metadata: result.metadata,
+        });
+    }
+    async completeUpload(args) {
+        const result = await this.pica.audioFiles.completeUpload({
+            uploadId: args.upload_id,
+            key: args.key,
+            bucket: args.bucket,
+            metadata: {
+                filename: args.filename,
+                contentType: args.content_type,
+                fileSize: args.file_size,
+                workId: args.work_id,
+                title: args.title,
+                fileType: args.file_type,
+                stemLabel: args.stem_label,
+                versionLabel: args.version_label,
+                recordingId: args.recording_id,
+                classification: args.classification,
+            },
+        });
+        const hints = [
+            {
+                gap: "audio_not_analysed",
+                suggestion: "Run pica_audio_analyze to extract BPM, key, energy, and mood",
+                severity: "important",
+            },
+            {
+                gap: "audio_not_identified",
+                suggestion: "Run pica_audio_identify to fingerprint and match against ACRCloud",
+                severity: "nice_to_have",
+            },
+        ];
+        if (!args.work_id) {
+            hints.unshift({
+                gap: "audio_not_linked",
+                suggestion: "Link this audio file to a work",
+                severity: "critical",
+            });
+        }
+        return formatSuccess(`Upload finalized. Audio file created with ID: ${result.audioFileId}.`, result, hints);
+    }
+    async identifyAudioFile(args) {
+        const result = await this.pica.audioFiles.identify(args.id, {
+            force: args.force,
+        });
+        if (result.alreadyIdentified) {
+            return formatSuccess("Already identified — no credits charged. Use force: true to re-identify.", result);
+        }
+        else if (result.status === "matched" && result.match) {
+            return formatSuccess(`Match found: "${result.match.title}" by ${result.match.artist} (confidence: ${Math.round((result.match.confidence || 0) * 100)}%). ISRC: ${result.match.isrc || "unknown"}. If the file is linked to a work, metadata has been propagated.`, result);
+        }
+        else if (result.status === "no_match") {
+            return formatSuccess("No match found in ACRCloud database. This may be an unreleased or very rare track.", result);
+        }
+        else {
+            return formatAsText(result);
+        }
+    }
+}
+//# sourceMappingURL=audio-files.js.map

package/dist/tools/audio-files.js.map

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

package/dist/tools/bulk.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Bulk Operations Tools - MCP tools for batch updates
+ */
+import { PicaClient } from "../pica-sdk.js";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class BulkTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private bulkUpdateWorks;
+    private bulkUpdatePeopleRoles;
+}
+//# sourceMappingURL=bulk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../src/tools/bulk.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,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;YAqD3D,eAAe;YAkBf,qBAAqB;CAkBpC"}