add_release_to_user_collection_folder
Add a release to a folder in a user's collection. The folder_id must be non-zero.
Identify a record by barcode, file it into a collection folder, and find out what the same pressing is selling for.
LABSCO SUMMARY
Search reaches the fields that identify a physical copy — barcode, catalogue number, credit, track — so pinning down which pressing you are holding is a call rather than a scroll through versions. Collection, wantlist and marketplace tools all key off the same username, which makes "do I already own this, and what is it going for" answerable without switching context.
A client for the Discogs API: 53 tools spanning the catalogue (releases, masters, artists, labels), a user's collection and wantlist, and the marketplace — listings, orders and order messages.
A Discogs account and a personal access token in DISCOGS_PERSONAL_ACCESS_TOKEN, plus npx on your PATH.
One command plus a key — npx -y discogs-mcp-server, then supply credentials
USE CASES
Search on the barcode or catalogue number printed on the sleeve, open the release it matches, and list the other versions of that master when you need to tell two pressings apart by country or format.
Add the release to the collection folder that stands for that shelf, rate it, and write your own notes fields — where you bought it, what you paid — against that copy.
Look the release up directly in the collection rather than scrolling it, and check the wantlist in the same breath so a duplicate purchase and a forgotten want are both settled before you pay.
Read the marketplace statistics for the release in the currency you sell in, then create the listing with condition, sleeve condition, price and whether you will take offers.
Pull the orders that are still open, read the message log on the one being asked about, reply into that log, and move the order's status and shipping when it is settled.
Request the CSV export, check the list of recent exports for the one that finished, and download it — useful when the accounting for a stall or a shop happens outside Discogs.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_release_to_user_collection_folderAdd a release to a folder in a user's collection. The folder_id must be non-zero.
add_to_wantlistAdd a release to a user's wantlist
create_marketplace_listingCreate a new marketplace listing
create_marketplace_order_messageAdds a new message to the order's message log
create_user_collection_folderCreate a new folder in a user's collection
delete_item_in_wantlistDelete a release from a user's wantlist
delete_marketplace_listingDelete a marketplace listing
delete_release_from_user_collection_folderRemove an instance of a release from a user's collection folder. The folder_id must be non-zero.
delete_release_ratingDeletes the release's rating for a given user
delete_user_collection_folderDelete a folder from a user's collection. A folder must be empty before it can be deleted.
download_inventory_exportDownload an inventory export as a CSV
edit_item_in_wantlistEdit a release in a user's wantlist
edit_marketplace_orderEdit a marketplace order
edit_release_ratingUpdates the release's rating for a given user
edit_user_collection_custom_field_valueEdit a custom field value for a release in a user's collection
edit_user_collection_folderEdit a folder's metadata. Folders 0 and 1 cannot be renamed.
edit_user_profileEdit a user's profile data
fetch_imageFetch an image by URL
find_release_in_user_collectionFind a release in a user's collection
get_artistGet an artist
get_artist_releasesGet an artist's releases
get_inventory_exportGet details about an inventory export
get_inventory_exportsGet a list of all recent exports of your inventory
get_labelGet a label
get_label_releasesReturns a list of Releases associated with the label
get_listGet a list by ID
get_marketplace_listingGet a listing from the marketplace
get_marketplace_orderGet a marketplace order
get_marketplace_order_messagesGet a list of an order's messages
get_marketplace_ordersGet a list of marketplace orders
get_marketplace_release_statsRetrieve marketplace statistics for the provided Release ID
get_master_releaseGet a master release
get_master_release_versionsRetrieves a list of all Releases that are versions of this master
get_releaseGet a release
get_release_community_ratingRetrieves the release community rating average and count
get_release_rating_by_userRetrieves the release's rating for a given user
get_user_collection_custom_fieldsRetrieve a list of user-defined collection notes fields. These fields are available on every release in the collection.
get_user_collection_folderRetrieve metadata about a folder in a user's collection
get_user_collection_foldersRetrieve a list of folders in a user's collection
get_user_collection_itemsRetrieve a list of items in a user's collection
get_user_collection_valueReturns the minimum, median, and maximum value of a user's collection
get_user_contributionsRetrieve a user's contributions by username
get_user_identityRetrieve basic information about the authenticated user
get_user_inventoryReturns the list of listings in a user's inventory
get_user_listsGet a user's lists
get_user_profileRetrieve a user by username
get_user_submissionsRetrieve a user's submissions by username
get_user_wantlistReturns the list of releases in a user's wantlist
inventory_exportRequest an export of your inventory as a CSV
move_release_in_user_collectionMove a release in a user's collection to another folder
rate_release_in_user_collectionRate a release in a user's collection. The folder_id must be non-zero.
searchIssue a search query to the Discogs database
update_marketplace_listingUpdate a marketplace listing
BEFORE YOU INSTALL
53 tools when we connected. Many tools write: they create, edit and delete collection folders, wantlist items, ratings, marketplace listings and orders. Uploading an inventory is not supported.
CONTEXT COST
Rated by the size of the 53 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx -y discogs-mcp-server{
"mcpServers": {
"discogs": {
"command": "npx",
"args": [
"-y",
"discogs-mcp-server"
],
"env": {
"DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}git clone https://github.com/cswkim/discogs-mcp-server.git
cd discogs-mcp-server
pnpm install{
"mcpServers": {
"discogs": {
"command": "npx",
"args": [
"tsx",
"<YOUR_PATH_TO_PROJECT_FOLDER>/src/index.ts"
],
"env": {
"DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}<YOUR_PATH_TO_PROJECT_FOLDER> is the absolute path of your clone, and <YOUR_TOKEN> is your Discogs personal access token (Discogs Settings > Developers).
git clone https://github.com/cswkim/discogs-mcp-server.git
cd discogs-mcp-serverCreate a .env file in the clone based on .env.example, and set DISCOGS_PERSONAL_ACCESS_TOKEN in it
docker build -t discogs-mcp-server:latest .{
"mcpServers": {
"discogs": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env-file",
"<YOUR_PATH_TO_PROJECT_FOLDER>/.env",
"discogs-mcp-server:latest"
]
}
}
}<YOUR_PATH_TO_PROJECT_FOLDER>/.env is the absolute path of that .env file.
In librechat.yaml, add this under the mcpServers section:
discogs:
type: stdio
command: npx
args: ["-y", "discogs-mcp-server"]
env:
DISCOGS_PERSONAL_ACCESS_TOKEN: <YOUR_DISCOGS_PERSONAL_ACCESS_TOKEN><YOUR_DISCOGS_PERSONAL_ACCESS_TOKEN> is your Discogs personal access token (Discogs Settings > Developers).
{
"mcpServers": {
"discogs": {
"command": "npx",
"args": [
"-y",
"discogs-mcp-server"
],
"env": {
"DISCOGS_PERSONAL_ACCESS_TOKEN": "<YOUR_DISCOGS_PERSONAL_ACCESS_TOKEN>"
}
}
}
}