discogs-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP port. Default 3000. Bound to 127.0.0.1. | 3000 |
| DISCOGS_TOKEN | No | Discogs personal access token. Required unless DISCOGS_ANONYMOUS=true. At least 8 characters. Sent as Authorization: Discogs token=<token>. | |
| MCP_TRANSPORT | No | stdio or http. --http overrides. | stdio |
| DISCOGS_CONTACT | Yes | Required. Email address or http(s) URL used in the User-Agent. The server refuses to start without it. | |
| DISCOGS_BASE_URL | No | Override for tests. Default https://api.discogs.com. Must be https, or http on 127.0.0.1 or localhost. | https://api.discogs.com |
| DISCOGS_TOOLSETS | No | Comma list of toolsets, or all. Default info,database,user,collection,wantlist,lists. marketplace and inventory are opt-in. | info,database,user,collection,wantlist,lists |
| DISCOGS_USERNAME | No | Default username path parameter. If unset, the connector calls GET /oauth/identity once and caches the name in memory. | |
| DISCOGS_ANONYMOUS | No | Set to true for public read-only calls with no token (25 requests per minute). Database toolset plus marketplace stats only. | false |
| DISCOGS_TIMEOUT_MS | No | Upstream timeout. Default 20000. | 20000 |
| DISCOGS_ALLOW_WRITES | No | Must be the literal true before a confirmed write is sent. | false |
| DISCOGS_MAX_CSV_BYTES | No | Inventory CSV size cap. Default 1000000. | 1000000 |
| DISCOGS_CACHE_TTL_SECONDS | No | In-memory TTL for public database GETs. Default 300. Hard cap 21600 (6 hours). Larger values are rejected. | 300 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Local Discogs MCP connector. Bring your own personal access token. Not a hosted service. HTTP mode binds to 127.0.0.1 for a single token holder. Data provided by Discogs. https://www.discogs.com This application uses Discogs' API but is not affiliated with, sponsored or endorsed by Discogs. 'Discogs' is a trademark of Zink Media, LLC. Writes need confirm=true and DISCOGS_ALLOW_WRITES=true. Omit confirm for a dry-run preview. Restricted Data (collections, wantlists, marketplace, images, user data) is for personal use by the token holder. Image URLs are dropped unless include_image_urls is true. URLs are never fetched. This application uses Discogs' API but is not affiliated with, sponsored or endorsed by Discogs. 'Discogs' is a trademark of Zink Media, LLC.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| discogs_infoB | Connector status: version, enabled toolsets, writes, rate-limit state, cache TTL, attribution, and a terms note. Always on. |
| discogs_collectionA | 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. |
| discogs_databaseA | discogs_database covers the database toolset (11 operations). Token is sent as Authorization: Discogs token= and never in the query string. Local stdio server for one user. Not a hosted service. Actions: get_artist: GET /artists/{artist_id}. Get one artist by id. get_artist_releases: GET /artists/{artist_id}/releases. List releases for an artist. get_label: GET /labels/{label_id}. Get one label by id. get_label_releases: GET /labels/{label_id}/releases. List releases for a label. get_master: GET /masters/{master_id}. Get one master release by id. get_master_versions: GET /masters/{master_id}/versions. List versions of a master release. get_release: GET /releases/{release_id}. Get one release by id. get_release_rating: GET /releases/{release_id}/rating. Get the community rating for a release. get_release_stats: GET /releases/{release_id}/stats. Get community stats for a release (have, want). get_user_release_rating: GET /releases/{release_id}/rating/{username}. Get one user's rating for a release. search: GET /database/search. Search the Discogs database. Requires a token. Anonymous search is refused by Discogs. |
| discogs_listsA | discogs_lists covers the lists toolset (2 operations). Token is sent as Authorization: Discogs token= and never in the query string. Local stdio server for one user. Not a hosted service. Actions: get: GET /lists/{list_id}. Get one list by id. list: GET /users/{username}/lists. List a user's lists. |
| discogs_userA | discogs_user covers the user toolset (5 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: edit_profile: POST /users/{username}. Edit the authenticated user's profile. get_identity: GET /oauth/identity. Return the identity of the authenticated token holder. get_profile: GET /users/{username}. Get a user profile. Profile HTML/BBCode is requested as plaintext. list_contributions: GET /users/{username}/contributions. List a user's contributions. list_submissions: GET /users/{username}/submissions. List a user's submissions. |
| discogs_wantlistA | discogs_wantlist covers the wantlist toolset (4 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: POST /users/{username}/wants/{release_id}. Add a release to the wantlist. delete: DELETE /users/{username}/wants/{release_id}. Remove a release from the wantlist. Warning: This removes a release from the wantlist. list: GET /users/{username}/wants. List the user's wantlist. update: PUT /users/{username}/wants/{release_id}. Add or update a wantlist item (notes, rating). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool maps to a distinct Discogs domain: info, collection, database, lists, user, and wantlist. Boundaries are mostly clear, though rating-related operations are split between discogs_collection and discogs_database, which could cause some hesitation.
All tools follow a consistent discogs_<domain> snake_case pattern. The convention is predictable and uniform across the entire set.
Six top-level tools is well-scoped for a Discogs MCP, with related operations grouped into domain-specific toolsets rather than exposing dozens of individual endpoints. Each tool earns its place.
The surface covers the major Discogs areas: collection CRUD/folders/fields/value/ratings, database artist/label/master/release/search, lists, user profile/submissions/contributions, and wantlist operations. No obvious workflow dead ends are apparent for the stated purpose.