discogs_collection
Manage a Discogs collection: add or remove releases, organize folders, set ratings and custom fields, and retrieve estimated value with confirmed writes and dry-run previews.
Instructions
discogs_collection covers the collection toolset (15 operations). Token is sent as Authorization: Discogs token= and never in the query string. Local stdio server for one user. Not a hosted service. Writes need confirm set to the boolean true and DISCOGS_ALLOW_WRITES=true. Omit confirm for a dry-run preview that does not send the request. Actions: add_release: POST /users/{username}/collection/folders/{folder_id}/releases/{release_id}. Add a release to a collection folder. Add targets folder 1 (Uncategorized), not folder 0 (All). create_folder: POST /users/{username}/collection/folders. Create a collection folder. delete_folder: DELETE /users/{username}/collection/folders/{folder_id}. Delete a collection folder. Folder 0 and folder 1 cannot be deleted. Warning: This deletes a collection folder. Folder 0 (All) and folder 1 (Uncategorized) cannot be deleted. delete_instance: DELETE /users/{username}/collection/folders/{folder_id}/releases/{release_id}/instances/{instance_id}. Remove a release instance from the collection. Warning: This removes a release instance from the collection. delete_release_rating: DELETE /releases/{release_id}/rating/{username}. Delete the authenticated user's rating for a release. Warning: This deletes the user's rating for the release. find_release: GET /users/{username}/collection/releases/{release_id}. Find a release across collection folders. get_folder: GET /users/{username}/collection/folders/{folder_id}. Get one collection folder. get_value: GET /users/{username}/collection/value. Get the estimated value of the collection. list_fields: GET /users/{username}/collection/fields. List custom collection fields. list_folder_releases: GET /users/{username}/collection/folders/{folder_id}/releases. List releases in a collection folder. list_folders: GET /users/{username}/collection/folders. List collection folders. Folder 0 is All. Folder 1 is Uncategorized. set_release_rating: PUT /releases/{release_id}/rating/{username}. Set the authenticated user's rating (1-5) for a release. update_field: POST /users/{username}/collection/folders/{folder_id}/releases/{release_id}/instances/{instance_id}/fields/{field_id}. Set a custom field value on a collection instance. update_folder: POST /users/{username}/collection/folders/{folder_id}. Rename a collection folder. Folder 0 and folder 1 cannot be edited. update_instance: POST /users/{username}/collection/folders/{folder_id}/releases/{release_id}/instances/{instance_id}. Change the rating of a collection instance or move it to another folder.
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": "discogs_collection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | JSON object for writes, or {csv} for inventory uploads. Tokens are redacted in output. | |
| query | No | OpenAPI query parameters, such as page or per_page. | |
| action | Yes | Discogs operation to call. | |
| params | No | OpenAPI path parameters, such as release_id or username. | |
| 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. | |
| include_image_urls | No | If true, keep image URL strings (images, thumb, cover_image, avatar_url). URLs are never fetched. Default false drops those fields. |