Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTNoHTTP port. Default 3000. Bound to 127.0.0.1.3000
DISCOGS_TOKENNoDiscogs personal access token. Required unless DISCOGS_ANONYMOUS=true. At least 8 characters. Sent as Authorization: Discogs token=<token>.
MCP_TRANSPORTNostdio or http. --http overrides.stdio
DISCOGS_CONTACTYesRequired. Email address or http(s) URL used in the User-Agent. The server refuses to start without it.
DISCOGS_BASE_URLNoOverride for tests. Default https://api.discogs.com. Must be https, or http on 127.0.0.1 or localhost.https://api.discogs.com
DISCOGS_TOOLSETSNoComma 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_USERNAMENoDefault username path parameter. If unset, the connector calls GET /oauth/identity once and caches the name in memory.
DISCOGS_ANONYMOUSNoSet to true for public read-only calls with no token (25 requests per minute). Database toolset plus marketplace stats only.false
DISCOGS_TIMEOUT_MSNoUpstream timeout. Default 20000.20000
DISCOGS_ALLOW_WRITESNoMust be the literal true before a confirmed write is sent.false
DISCOGS_MAX_CSV_BYTESNoInventory CSV size cap. Default 1000000.1000000
DISCOGS_CACHE_TTL_SECONDSNoIn-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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4/5.0

Scored across 6 tools

Disambiguation4/5

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.

Naming Consistency5/5

All tools follow a consistent discogs_<domain> snake_case pattern. The convention is predictable and uniform across the entire set.

Tool Count5/5

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.

Completeness5/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues