ampache_catalogs
Manage Ampache catalogs, run catalog add/clean/verify/update tasks, inspect catalog files and folders, and handle flags, ratings, plays, or song deletion with write confirmation.
Instructions
Catalogs, catalog tasks (add_to_catalog, clean_catalog, verify_catalog, update_catalog, gather_art), catalog file/folder, flag, rate, record_play, and song_delete. Writes run only when confirm is true and AMPACHE_ALLOW_WRITES=true. List actions default to offset 0 and limit 25 (max 500). Actions: catalog, catalog_action, catalog_add, catalog_create, catalog_delete, catalog_file, catalog_folder, catalogs, flag, rate, record_play, scrobble, song_delete, update_art, update_artist_info, update_from_tags.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "ampache_catalogs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| uri | No | ||
| date | No | ||
| file | No | ||
| flag | No | ||
| name | No | ||
| path | No | ||
| song | No | ||
| task | No | ||
| type | No | ||
| user | No | ||
| album | No | ||
| limit | No | ||
| action | Yes | Ampache operation to call. | |
| artist | No | ||
| client | No | ||
| filter | No | ||
| folder | No | ||
| offset | No | ||
| rating | No | ||
| catalog | No | ||
| confirm | No | Boolean true runs the write when AMPACHE_ALLOW_WRITES is true. Omit it or pass false for a dry-run preview that sends nothing. The string true is rejected. | |
| cat_name | No | ||
| password | No | ||
| songmbid | No | ||
| username | No | ||
| albummbid | No | ||
| overwrite | No | ||
| artistmbid | No | ||
| media_type | No | ||
| file_pattern | No | ||
| gather_types | No | ||
| folder_pattern | No |