kavita_collection
Manage Kavita collections by retrieving, importing, promoting, updating, and deleting collection entries, with dry-run previews and explicit confirmation required for write operations.
Instructions
kavita_collection covers the collection toolset (12 operations). Auth is the x-api-key header, or a JWT from KAVITA_USERNAME and KAVITA_PASSWORD. Self-hosted Kavita only. action help with target returns one action's parameters. Writes need confirm set to the boolean true and KAVITA_ALLOW_WRITES=true. Omit confirm for a dry-run preview that sends nothing. Destructive, credential, or exposure actions add an extra warning in the preview and here: delete, scan, analyze, refresh, cache clear, cleanup, user or role changes, Auth Key create or revoke, password reset, settings, license, scrobbling tokens, OAuth or OIDC, and email. Actions: delete, get, get_all_series, get_mal_stacks, get_name_exists, get_single, post_delete_multiple, post_import_stack, post_promote_multiple, post_update, post_update_for_series, post_update_series.
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": "kavita_collection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | JSON body for the Kavita operation. Secrets are redacted in output. | |
| query | No | OpenAPI query parameters. | |
| action | Yes | Kavita operation to call, or help. | |
| params | No | OpenAPI path parameters, such as seriesId. | |
| target | No | With action help, the action whose parameters to describe. | |
| confirm | No | Set to the boolean true to execute the write. Omit this field for a dry-run preview. false and the string true are rejected. |