Discogs Pet

Access the Discogs music database and marketplace API. Search for releases, artists, labels, and manage your collection.

Setup

1. Create a Discogs account at discogs.com
2. Go to Developer Settings
3. Click "Generate new token"
4. Add to your .env file:

DISCOGS_TOKEN=your_token_here

Core Tools (Always Loaded)

| Tool | Description | |------|-------------| | discogs-test-connection | Test API connection | | discogs-search-database | Search releases, artists, labels | | discogs-get-release | Get release details | | discogs-get-master-release | Get master release | | discogs-get-master-release-versions | List all versions of a master | | discogs-get-artist | Get artist details | | discogs-get-artist-releases | List artist's discography | | discogs-get-label | Get label details | | discogs-get-label-releases | List label's releases |

Composite Tools (Optimized for Common Workflows)

These tools combine multiple API calls to reduce round-trips:

| Tool | Description | |------|-------------| | discogs-search-and-get | Search and auto-fetch full details for top results | | discogs-get-artist-with-releases | Get artist info + discography in one call | | discogs-get-master-with-versions | Get master release + all pressing variants | | discogs-get-label-with-releases | Get label info + catalog in one call |

Consolidated Management Tools

| Tool | Description | |------|-------------| | discogs-manage-collection | Unified collection management (list-folders, get-items, add-release) | | discogs-manage-wantlist | Unified wantlist management (list, add, remove) |

Additional Tool Groups

Enable additional tools by setting environment variables:

# Marketplace tools (listings, inventory)
DISCOGS_LOAD_MARKETPLACE_TOOLS=true

# User identity tools (profile)
DISCOGS_LOAD_USER_IDENTITY_TOOLS=true

# Collection management
DISCOGS_LOAD_USER_COLLECTION_TOOLS=true

# Wantlist management
DISCOGS_LOAD_USER_WANTLIST_TOOLS=true

Example Queries

# Search and get full details for top results
opencode run "search and get details for radiohead ok computer"

# Get artist with their discography
opencode run "get radiohead artist info with releases, artist id 3840"

# Get master release with all versions
opencode run "get master release 21491 with all pressing versions"

# Search for an artist
opencode run "search discogs for radiohead"

# Get a specific release
opencode run "get discogs release 249504"

# Search by genre and year
opencode run "search discogs for jazz albums from 1959"

# Manage collection (requires DISCOGS_LOAD_USER_COLLECTION_TOOLS=true)
opencode run "list my discogs collection folders for username myuser"

# Manage wantlist (requires DISCOGS_LOAD_USER_WANTLIST_TOOLS=true)
opencode run "add release 249504 to my discogs wantlist for username myuser"

Rate Limits

• Authenticated: 60 requests/minute
• Unauthenticated: 25 requests/minute

API Documentation

• Discogs API Docs
• OpenAPI Spec (community-maintained)