@withpica/mcp-server 2.104.0 → 2.105.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/README.md +3 -3
  3. package/dist/lib/changelog.generated.d.ts +2 -2
  4. package/dist/lib/changelog.generated.d.ts.map +1 -1
  5. package/dist/lib/changelog.generated.js +2 -2
  6. package/dist/lib/changelog.generated.js.map +1 -1
  7. package/dist/tools/app-tools.js +1 -1
  8. package/dist/tools/app-tools.js.map +1 -1
  9. package/dist/tools/assets.d.ts +1 -0
  10. package/dist/tools/assets.d.ts.map +1 -1
  11. package/dist/tools/assets.js +45 -40
  12. package/dist/tools/assets.js.map +1 -1
  13. package/dist/tools/audio-files.js +6 -6
  14. package/dist/tools/audio-files.js.map +1 -1
  15. package/dist/tools/discovery.d.ts.map +1 -1
  16. package/dist/tools/discovery.js +5 -0
  17. package/dist/tools/discovery.js.map +1 -1
  18. package/dist/tools/enrichment.d.ts.map +1 -1
  19. package/dist/tools/enrichment.js +4 -0
  20. package/dist/tools/enrichment.js.map +1 -1
  21. package/dist/tools/explainability.js +1 -1
  22. package/dist/tools/explainability.js.map +1 -1
  23. package/dist/tools/exports.d.ts.map +1 -1
  24. package/dist/tools/exports.js +15 -8
  25. package/dist/tools/exports.js.map +1 -1
  26. package/dist/tools/import.d.ts.map +1 -1
  27. package/dist/tools/import.js +6 -2
  28. package/dist/tools/import.js.map +1 -1
  29. package/dist/tools/index.d.ts +12 -0
  30. package/dist/tools/index.d.ts.map +1 -1
  31. package/dist/tools/index.js +4 -0
  32. package/dist/tools/index.js.map +1 -1
  33. package/dist/tools/metadata.d.ts.map +1 -1
  34. package/dist/tools/metadata.js +7 -1
  35. package/dist/tools/metadata.js.map +1 -1
  36. package/dist/tools/notifications.js +3 -3
  37. package/dist/tools/notifications.js.map +1 -1
  38. package/dist/tools/recovery-hints.d.ts.map +1 -1
  39. package/dist/tools/recovery-hints.js +25 -0
  40. package/dist/tools/recovery-hints.js.map +1 -1
  41. package/dist/tools/send.js +1 -1
  42. package/dist/tools/send.js.map +1 -1
  43. package/dist/tools/share-links.js +3 -3
  44. package/dist/tools/share-links.js.map +1 -1
  45. package/dist/tools/split-sheets.d.ts.map +1 -1
  46. package/dist/tools/split-sheets.js +4 -0
  47. package/dist/tools/split-sheets.js.map +1 -1
  48. package/package.json +2 -2
  49. package/server.json +2 -2
package/CHANGELOG.md CHANGED
@@ -11,6 +11,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
11
11
 
12
12
  ## [Unreleased]
13
13
 
14
+ ## [2.105.0] - 2026-10-15
15
+
16
+ ### Added
17
+
18
+ - `pica_physical_assets_market_check` — an AI market price estimate for a physical
19
+ asset, from the organisation's own AI provider. A write (`write:catalog`), so a
20
+ client confirms before it runs.
21
+ - A tool definition can declare `alsoRequires`: scopes a credential must hold as
22
+ well as `scope`. `pica_tool_details` reports them as `also_requires`.
23
+
24
+ ### Fixed
25
+
26
+ - `pica_export_snapshot`, `pica_export_song_dossiers` and
27
+ `pica_export_catalog_asset_report` declare both scopes their routes need
28
+ (`write:catalog` and `write:files`). Each declared one, so a credential
29
+ holding only what the tool advertised was refused 403 underneath.
30
+ - `pica_run_person_cascade` and `pica_split_sheet_send` also require
31
+ `write:people`, which their routes already needed.
32
+ - `pica_share_links_create`, `_update`, `_delete` and `pica_upload` require
33
+ `write:files` (a share or an upload is a file operation), as their routes now do.
34
+ - `pica_audio_assign`, `_bulk_assign_suggested`, `_dismiss_match`, `_update` and
35
+ `_bulk_update` require `write:catalog`: they attach or edit audio against the
36
+ catalogue, and their routes are floored there. Upload, analyse and identify
37
+ stay `write:files`, and their routes' floor is now `write:files` too.
38
+ - `pica_notification_acknowledge` requires `write:catalog`: it acknowledges
39
+ catalogue discoveries, which is what its route requires.
40
+ - `pica_physical_assets_query`, `pica_physical_assets_inspect`,
41
+ `pica_audio_pipeline_status`, `pica_count_explain`, `pica_notifications_list`
42
+ and `pica_send_query` require `read:catalog`, which their routes require.
43
+ - `pica_notifications_recent` requires `read:catalog`; its route, and
44
+ `pica_discoveries_query`'s, no longer require `write:catalog` for a read.
45
+ - `pica_physical_assets_inspect` no longer has a `market` section: a read never
46
+ calls an AI provider. Use `pica_physical_assets_market_check`.
47
+ - `pica_import_analyze` is a write tool (`write:catalog`): it spends PICA's
48
+ paid AI model on the file, so a client asks before running it.
49
+
50
+ - The seven physical-asset write tools (`pica_physical_assets_create`,
51
+ `_update`, `_delete`, `_link_work`, `_link_recording`, `_unlink_work`,
52
+ `_unlink_recording`) declare `write:catalog`, the scope their routes and the
53
+ REST write floor require. They declared `write:files`, so a credential holding
54
+ exactly that passed MCP dispatch and was refused 403 underneath.
55
+
14
56
  ## [2.104.0] - 2026-10-14
15
57
 
16
58
  ### Added
@@ -52,6 +94,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
52
94
 
53
95
  ### Changed
54
96
 
97
+ - `pica_export_snapshot` says it is for an owner or admin of the catalogue only;
98
+ its route now refuses anyone else.
99
+
55
100
  - `pica_find_duplicates`: recording and release groups no longer include a pair the owner marked
56
101
  different, and their "keep them separate" option now says how to stop them coming back
57
102
  (it used to say they would keep appearing). A group never holds a marked pair, even through a
package/README.md CHANGED
@@ -65,7 +65,7 @@ Read tools are annotated read-only and are safe to call freely. Write tools repo
65
65
 
66
66
  ## Tools
67
67
 
68
- 367 tools, grouped below by the taxonomy `pica_discover` uses. The server's own `tools/list` is authoritative — not every registered tool is filed under a category yet, so the names below are a map, not a census.
68
+ 368 tools, grouped below by the taxonomy `pica_discover` uses. The server's own `tools/list` is authoritative — not every registered tool is filed under a category yet, so the names below are a map, not a census.
69
69
 
70
70
  **works** — manage your musical works
71
71
 
@@ -225,7 +225,7 @@ Read tools are annotated read-only and are safe to call freely. Write tools repo
225
225
 
226
226
  **physical assets** — manage physical assets (master tapes, hardware, artefacts)
227
227
 
228
- `pica_physical_assets_query`, `pica_physical_assets_inspect`, `pica_physical_assets_create`, `pica_physical_assets_update`, `pica_physical_assets_delete`, `pica_physical_assets_export`, `pica_physical_assets_stats`, `pica_physical_assets_link_work`, `pica_physical_assets_link_recording`, `pica_physical_assets_unlink_work`, `pica_physical_assets_unlink_recording`
228
+ `pica_physical_assets_query`, `pica_physical_assets_inspect`, `pica_physical_assets_create`, `pica_physical_assets_update`, `pica_physical_assets_market_check`, `pica_physical_assets_delete`, `pica_physical_assets_export`, `pica_physical_assets_stats`, `pica_physical_assets_link_work`, `pica_physical_assets_link_recording`, `pica_physical_assets_unlink_work`, `pica_physical_assets_unlink_recording`
229
229
 
230
230
  **portfolio** — who looks after a catalogue — see and answer requests, invite an organisation or a client by email, end access, see what was done through a relationship, (for organisations) the client catalogues you look after with what needs doing, and preparing a catalogue for a client to take over
231
231
 
@@ -297,4 +297,4 @@ Read tools are annotated read-only and are safe to call freely. Write tools repo
297
297
 
298
298
  ---
299
299
 
300
- Generated for `@withpica/mcp-server@2.104.0`. © 2024-2026 Withpica Ltd. All rights reserved. MIT licensed.
300
+ Generated for `@withpica/mcp-server@2.105.0`. © 2024-2026 Withpica Ltd. All rights reserved. MIT licensed.