MCP VinylShopper
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DISCOGS_TOKEN | Yes | Your Discogs personal access token. Required to authenticate with the Discogs API. | |
| EBAY_CLIENT_ID | No | eBay production App ID (Client ID). Optional; enables eBay search. | |
| DISCOGS_USERNAME | Yes | Your Discogs username. Required for identity and collection operations. | |
| DISCOGS_USER_AGENT | No | User agent string sent to Discogs API. Defaults to mcp-vinylshopper/0.3.0. | mcp-vinylshopper/0.3.0 |
| EBAY_CLIENT_SECRET | No | eBay production Cert ID (Client Secret). Optional; enables eBay search. | |
| EBAY_MARKETPLACE_ID | No | eBay marketplace identifier. Defaults to EBAY_US. | EBAY_US |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
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_identityA | Verify authentication and return the authenticated Discogs identity. |
| search_databaseA | Search Discogs releases, masters, artists, or labels with optional catalog filters. |
| get_releaseA | Get full details for a Discogs release, including tracklist, formats, labels, and identifiers. |
| get_masterC | Get full details for a Discogs master release. |
| get_master_versionsB | List release versions belonging to a Discogs master. |
| get_artistC | Get Discogs artist details. |
| get_artist_releasesC | List releases associated with a Discogs artist. |
| get_labelC | Get Discogs label details. |
| get_price_suggestionsC | Get marketplace price suggestions by media and sleeve condition for a release. |
| get_marketplace_statsB | Get marketplace listing count and lowest price for a release. |
| get_collectionC | List releases in a Discogs user's collection folder. |
| get_wantlistB | List releases in a Discogs user's wantlist. |
| discogs_api_requestA | Call any JSON Discogs API v2 endpoint. Use named tools when available. Checkout and payment are not API endpoints. |
| get_user_profileC | Get a Discogs user profile. |
| edit_user_profileC | Edit the authenticated user's supported public profile fields. |
| get_user_listsC | List a Discogs user's public lists. |
| get_listC | Get a Discogs list and its entries. |
| get_label_releasesC | List releases associated with a Discogs label. |
| get_collection_foldersC | List collection folders. |
| create_collection_folderC | Create a collection folder. |
| rename_collection_folderC | Rename a collection folder. |
| delete_collection_folderB | Delete a collection folder. Its releases are moved to Uncategorized by Discogs. |
| find_collection_releaseB | Find every collection instance of a release across folders. |
| add_to_collectionA | Add one copy of a release to a collection folder and return its instance ID. |
| edit_collection_instanceC | Move and/or rate one exact collection copy. |
| remove_collection_instanceC | Remove one exact copy from a collection. |
| get_collection_fieldsC | List custom collection fields. |
| set_collection_fieldB | Set a custom field value on one exact collection copy. |
| get_collection_valueC | Get the authenticated user's collection value estimate. |
| add_to_wantlistC | Add or update a release in a user's wantlist. |
| remove_from_wantlistB | Remove a release from a user's wantlist. |
| get_release_ratingC | Get a user's rating for a release. |
| set_release_ratingA | Set the authenticated user's rating for a release. |
| delete_release_ratingB | Delete the authenticated user's rating for a release. |
| get_inventoryC | List a Discogs seller's marketplace inventory. |
| get_listingC | Get a marketplace listing. |
| create_listingC | Create a marketplace seller listing. |
| edit_listingC | Edit a marketplace seller listing. |
| delete_listingC | Delete a marketplace seller listing. |
| get_ordersC | List authenticated marketplace purchases and sales. |
| get_orderB | Get an authenticated marketplace order. |
| edit_orderB | Update the status or shipping details of an existing marketplace order. |
| get_order_messagesC | List messages on an authenticated marketplace order. |
| post_order_messageB | Post a message on an authenticated marketplace order. |
| get_feeA | Calculate the Discogs marketplace fee for a price and currency. |
| get_currency_exchange_ratesA | Get Discogs marketplace currency exchange rates. |
| ebay_api_statusA | Verify eBay Browse API application authentication without exposing credentials. |
| search_ebay_vinylC | Search active eBay vinyl listings and return prices, sellers, condition, location, and shipping information. |
| get_ebay_itemB | Get current details for a specific eBay Browse API item ID. |
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 49 tools
Every tool targets a distinct resource or action, from search and lookup to collection/wantlist management, marketplace listings, orders, and eBay searches. Potential confusions like get_order/get_orders and add_to_collection/add_to_wantlist are resolved by singular/plural forms and clear domain-specific verbs.
The overwhelming majority of tools follow a verb_noun pattern (get_release, create_listing, add_to_wantlist). A few exceptions like discogs_identity, discogs_api_request, and ebay_api_status break the pattern, but the convention is still highly predictable.
At 49 tools, this is a very heavy surface that exceeds even the 'too many (25+)' threshold. While the broad Discogs + eBay scope justifies many distinct operations, the sheer count makes the toolbox unwieldy for agents to navigate effectively.
The tool surface thoroughly covers the vinyl-shopping workflow: database search, release/master/artist/label detail, collection folders and fields, wantlist, ratings, marketplace inventory, listings, orders, messages, fee calculation, currency exchange, and eBay item search. There are no significant gaps for the stated purpose.