Discogs website screenshot

Discogs

Discogs is a community-built music database and marketplace for physical music releases (vinyl, CD, cassette, and more). The Discogs API gives developers programmatic read/write access to artists, releases, masters, labels, search, user collections and wantlists, marketplace listings, orders, and inventory management — using Discogs Auth tokens, key+secret credentials, or full OAuth 1.0a on behalf of other users.

Discogs publishes 8 APIs on the APIs.io network, including Database API, Image API, Inventory Management API, and 5 more. Tagged areas include Music, Marketplace, Catalog, Community, and Vinyl.

The Discogs catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Discogs’ developer surface includes authentication, documentation, API reference, support, status page, engineering blog, tooling, and 19 more developer resources.

50.1/100 developing ▼ -5.9 Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
8 APIs
MusicMarketplaceCatalogCommunityVinylPublic APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 50.1/100 · developing
Contract Quality 16.1 / 25
Developer Ergonomics 6.5 / 20
Commercial Clarity 6.3 / 20
Operational Transparency 4.8 / 13
Governance 8.3 / 12
Discoverability 8.2 / 10
Agent readiness — 44/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/discogs: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

Discogs Database API

Access Discogs database: artists, releases, masters, labels, and search.

Discogs Image API

Image asset retrieval (proxied via OAuth).

Discogs Inventory Management API

Bulk inventory export and CSV upload management.

Discogs Marketplace API

Marketplace listings, orders, fees, price suggestions, and release stats.

Discogs User Collection API

Manage a user's record collection.

Discogs User Identity API

Authenticated user identity, profile, submissions, and contributions.

Discogs User Lists API

Browse and manage user-created lists of releases, artists, and labels.

Discogs User Wantlist API

Manage a user's wantlist.

Scroll for all 8

GraphQL 1

GraphQL schemas published by this provider.

Discogs GraphQL Schema

This document describes a conceptual GraphQL schema for the Discogs API. Discogs is a community-built music database and marketplace for physical music releases (vinyl, CD, cass...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Discogs Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Discogs Rate Limits

3 limits

RATE LIMITS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Discogs Context

49 classes · 159 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Discogs API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Discogs API Rules

35 rules · 11 errors 19 warnings 5 info

SPECTRAL

JSON Schema 55

Standalone JSON Schema definitions for this provider's data models.

ArtistRelease

11 properties

JSON SCHEMA

Artist

12 properties

JSON SCHEMA

ArtistSummary

7 properties

JSON SCHEMA

CollectionFolder

4 properties

JSON SCHEMA

CollectionRelease

6 properties

JSON SCHEMA

Community

7 properties

JSON SCHEMA

Contribution

2 properties

JSON SCHEMA

Currency

0 properties

JSON SCHEMA

Fee

2 properties

JSON SCHEMA

Identifier

3 properties

JSON SCHEMA

Identity

4 properties

JSON SCHEMA

Image

6 properties

JSON SCHEMA

InventoryExport

8 properties

JSON SCHEMA

InventoryExportsResponse

2 properties

JSON SCHEMA

InventoryUpload

7 properties

JSON SCHEMA

InventoryUploadsResponse

2 properties

JSON SCHEMA

LabelRelease

9 properties

JSON SCHEMA

Label

12 properties

JSON SCHEMA

LabelSummary

5 properties

JSON SCHEMA

ListItem

7 properties

JSON SCHEMA

List

11 properties

JSON SCHEMA

ListingNew

11 properties

JSON SCHEMA

ListingRelease

9 properties

JSON SCHEMA

Listing

18 properties

JSON SCHEMA

ListingUpdate

0 properties

JSON SCHEMA

ListsResponse

2 properties

JSON SCHEMA

Master

0 properties

JSON SCHEMA

MediaCondition

0 properties

JSON SCHEMA

OrderMessage

7 properties

JSON SCHEMA

OrderMessagesResponse

2 properties

JSON SCHEMA

Order

17 properties

JSON SCHEMA

OrdersResponse

2 properties

JSON SCHEMA

Pagination

5 properties

JSON SCHEMA

Price

2 properties

JSON SCHEMA

PriceSuggestion

2 properties

JSON SCHEMA

PriceSuggestionsResponse

0 properties

JSON SCHEMA

Profile

30 properties

JSON SCHEMA

ProfileUpdate

5 properties

JSON SCHEMA

ReleaseFormat

4 properties

JSON SCHEMA

ReleaseRating

2 properties

JSON SCHEMA

Release

31 properties

JSON SCHEMA

ReleaseStats

3 properties

JSON SCHEMA

ReleaseSummary

11 properties

JSON SCHEMA

ReleaseVersion

12 properties

JSON SCHEMA

SearchResultArtist

0 properties

JSON SCHEMA

SearchResultLabel

0 properties

JSON SCHEMA

SearchResultMaster

0 properties

JSON SCHEMA

SearchResultRelease

15 properties

JSON SCHEMA

SleeveCondition

0 properties

JSON SCHEMA

Submission

2 properties

JSON SCHEMA

Track

5 properties

JSON SCHEMA

UserReleaseRating

3 properties

JSON SCHEMA

UserSummary

3 properties

JSON SCHEMA

Video

5 properties

JSON SCHEMA

Want

5 properties

JSON SCHEMA

Scroll for all 55

JSON Structure 55

JSON Structure definitions describing this provider's data shapes.

Discogs Artist Release Structure

11 properties

JSON STRUCTURE

Discogs Artist Structure

12 properties

JSON STRUCTURE

Discogs Artist Summary Structure

7 properties

JSON STRUCTURE

Discogs Collection Folder Structure

4 properties

JSON STRUCTURE

Discogs Collection Release Structure

6 properties

JSON STRUCTURE

Discogs Community Structure

7 properties

JSON STRUCTURE

Discogs Contribution Structure

2 properties

JSON STRUCTURE

Discogs Currency Structure

0 properties

JSON STRUCTURE

Discogs Fee Structure

2 properties

JSON STRUCTURE

Discogs Identifier Structure

3 properties

JSON STRUCTURE

Discogs Identity Structure

4 properties

JSON STRUCTURE

Discogs Image Structure

6 properties

JSON STRUCTURE

Discogs Inventory Export Structure

8 properties

JSON STRUCTURE

Discogs Inventory Upload Structure

7 properties

JSON STRUCTURE

Discogs Label Release Structure

9 properties

JSON STRUCTURE

Discogs Label Structure

12 properties

JSON STRUCTURE

Discogs Label Summary Structure

5 properties

JSON STRUCTURE

Discogs List Item Structure

7 properties

JSON STRUCTURE

Discogs List Structure

11 properties

JSON STRUCTURE

Discogs Listing New Structure

11 properties

JSON STRUCTURE

Discogs Listing Release Structure

9 properties

JSON STRUCTURE

Discogs Listing Structure

18 properties

JSON STRUCTURE

Discogs Listing Update Structure

0 properties

JSON STRUCTURE

Discogs Lists Response Structure

2 properties

JSON STRUCTURE

Discogs Master Structure

0 properties

JSON STRUCTURE

Discogs Media Condition Structure

0 properties

JSON STRUCTURE

Discogs Order Message Structure

7 properties

JSON STRUCTURE

Discogs Order Messages Response Structure

2 properties

JSON STRUCTURE

Discogs Order Structure

17 properties

JSON STRUCTURE

Discogs Orders Response Structure

2 properties

JSON STRUCTURE

Discogs Pagination Structure

5 properties

JSON STRUCTURE

Discogs Price Structure

2 properties

JSON STRUCTURE

Discogs Price Suggestion Structure

2 properties

JSON STRUCTURE

Discogs Profile Structure

30 properties

JSON STRUCTURE

Discogs Profile Update Structure

5 properties

JSON STRUCTURE

Discogs Release Format Structure

4 properties

JSON STRUCTURE

Discogs Release Rating Structure

2 properties

JSON STRUCTURE

Discogs Release Stats Structure

3 properties

JSON STRUCTURE

Discogs Release Structure

31 properties

JSON STRUCTURE

Discogs Release Summary Structure

11 properties

JSON STRUCTURE

Discogs Release Version Structure

12 properties

JSON STRUCTURE

Discogs Search Result Artist Structure

0 properties

JSON STRUCTURE

Discogs Search Result Label Structure

0 properties

JSON STRUCTURE

Discogs Search Result Master Structure

0 properties

JSON STRUCTURE

Discogs Search Result Release Structure

15 properties

JSON STRUCTURE

Discogs Sleeve Condition Structure

0 properties

JSON STRUCTURE

Discogs Submission Structure

2 properties

JSON STRUCTURE

Discogs Track Structure

5 properties

JSON STRUCTURE

Discogs User Release Rating Structure

3 properties

JSON STRUCTURE

Discogs User Summary Structure

3 properties

JSON STRUCTURE

Discogs Video Structure

5 properties

JSON STRUCTURE

Discogs Want Structure

5 properties

JSON STRUCTURE

Scroll for all 55

Examples 49

Example request and response payloads for these APIs.

Discogs Artist Example

12 fields

EXAMPLE

Discogs Community Example

7 fields

EXAMPLE

Discogs Fee Example

2 fields

EXAMPLE

Discogs Identity Example

4 fields

EXAMPLE

Discogs Image Example

6 fields

EXAMPLE

Discogs Label Example

12 fields

EXAMPLE

Discogs List Example

11 fields

EXAMPLE

Discogs List Item Example

7 fields

EXAMPLE

Discogs Listing Example

18 fields

EXAMPLE

Discogs Listing New Example

11 fields

EXAMPLE

Discogs Master Example

0 fields

EXAMPLE

Discogs Order Example

17 fields

EXAMPLE

Discogs Price Example

2 fields

EXAMPLE

Discogs Profile Example

30 fields

EXAMPLE

Discogs Release Example

31 fields

EXAMPLE

Discogs Track Example

5 fields

EXAMPLE

Discogs Video Example

5 fields

EXAMPLE

Discogs Want Example

5 fields

EXAMPLE

Scroll for all 49

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Discogs Authentication

apiKey/oauth2 · 2 schemes

SECURITY

Discogs Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Discogs Scopes

2 scopes · authorizationCode

2 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Discogs Agentic Access

50 operations · 16 acting

50 operations · 16 acting

AGENTIC

Resources

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Build 6

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 4

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Other 2

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: discogs
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/discogs.png
name: Discogs
description: 'Discogs is a community-built music database and marketplace for physical music releases (vinyl, CD, cassette,
  and more). The Discogs API gives developers programmatic

  read/write access to artists, releases, masters, labels, search, user collections and wantlists, marketplace listings, orders,
  and inventory management — using Discogs

  Auth tokens, key+secret credentials, or full OAuth 1.0a on behalf of other users.

  '
url: https://www.discogs.com/developers/
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-29'
x-source: public-apis/public-apis
x-category: Music
x-tier: 2
x-tier-reason: Catalog + marketplace platform with a public REST API, OAuth1, well-documented endpoints, multiple community
  SDKs, and an active MCP ecosystem.
tags:
- Music
- Marketplace
- Catalog
- Community
- Vinyl
- Public APIs
apis:
- aid: discogs:discogs-database-api
  name: Discogs Database API
  description: 'Access Discogs database: artists, releases, masters, labels, and search.'
  humanURL: https://www.discogs.com/developers
  baseURL: https://api.discogs.com
  tags:
  - Database
  properties:
  - type: OpenAPI
    url: openapi/discogs-database-api-openapi.yml
  - type: Documentation
    url: https://www.discogs.com/developers
  - type: APIReference
    url: https://www.discogs.com/developers
  - type: Authentication
    url: https://www.discogs.com/developers#page:authentication
  - type: TermsOfService
    url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
  - type: SDKs
    url: https://github.com/joalla/discogs_client
  - type: SDKs
    url: https://github.com/jmfontaine/discogs-sdk
  - type: SDKs
    url: https://github.com/andy-miles/discogs-java-client
  - type: SDKs
    url: https://github.com/rock-n-code/discogs-service
  - type: SDKs
    url: https://github.com/discogs/discogs_client
  - type: BulkData
    url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
  - type: GraphQL
    url: graphql/discogs-graphql.md
- aid: discogs:discogs-image-api
  name: Discogs Image API
  description: Image asset retrieval (proxied via OAuth).
  humanURL: https://www.discogs.com/developers
  baseURL: https://api.discogs.com
  tags:
  - Image
  properties:
  - type: OpenAPI
    url: openapi/discogs-image-api-openapi.yml
  - type: Documentation
    url: https://www.discogs.com/developers
  - type: APIReference
    url: https://www.discogs.com/developers
  - type: Authentication
    url: https://www.discogs.com/developers#page:authentication
  - type: TermsOfService
    url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
  - type: SDKs
    url: https://github.com/joalla/discogs_client
  - type: SDKs
    url: https://github.com/jmfontaine/discogs-sdk
  - type: SDKs
    url: https://github.com/andy-miles/discogs-java-client
  - type: SDKs
    url: https://github.com/rock-n-code/discogs-service
  - type: SDKs
    url: https://github.com/discogs/discogs_client
  - type: BulkData
    url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
  - type: GraphQL
    url: graphql/discogs-graphql.md
- aid: discogs:discogs-inventory-management-api
  name: Discogs Inventory Management API
  description: Bulk inventory export and CSV upload management.
  humanURL: https://www.discogs.com/developers
  baseURL: https://api.discogs.com
  tags:
  - Inventory Management
  properties:
  - type: OpenAPI
    url: openapi/discogs-inventory-management-api-openapi.yml
  - type: Documentation
    url: https://www.discogs.com/developers
  - type: APIReference
    url: https://www.discogs.com/developers
  - type: Authentication
    url: https://www.discogs.com/developers#page:authentication
  - type: TermsOfService
    url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
  - type: SDKs
    url: https://github.com/joalla/discogs_client
  - type: SDKs
    url: https://github.com/jmfontaine/discogs-sdk
  - type: SDKs
    url: https://github.com/andy-miles/discogs-java-client
  - type: SDKs
    url: https://github.com/rock-n-code/discogs-service
  - type: SDKs
    url: https://github.com/discogs/discogs_client
  - type: BulkData
    url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
  - type: GraphQL
    url: graphql/discogs-graphql.md
- aid: discogs:discogs-marketplace-api
  name: Discogs Marketplace API
  description: Marketplace listings, orders, fees, price suggestions, and release stats.
  humanURL: https://www.discogs.com/developers
  baseURL: https://api.discogs.com
  tags:
  - Marketplace
  properties:
  - type: OpenAPI
    url: openapi/discogs-marketplace-api-openapi.yml
  - type: Documentation
    url: https://www.discogs.com/developers
  - type: APIReference
    url: https://www.discogs.com/developers
  - type: Authentication
    url: https://www.discogs.com/developers#page:authentication
  - type: TermsOfService
    url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
  - type: SDKs
    url: https://github.com/joalla/discogs_client
  - type: SDKs
    url: https://github.com/jmfontaine/discogs-sdk
  - type: SDKs
    url: https://github.com/andy-miles/discogs-java-client
  - type: SDKs
    url: https://github.com/rock-n-code/discogs-service
  - type: SDKs
    url: https://github.com/discogs/discogs_client
  - type: BulkData
    url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
  - type: GraphQL
    url: graphql/discogs-graphql.md
- aid: discogs:discogs-user-collection-api
  name: Discogs User Collection API
  description: Manage a user's record collection.
  humanURL: https://www.discogs.com/developers
  baseURL: https://api.discogs.com
  tags:
  - User Collection
  properties:
  - type: OpenAPI
    url: openapi/discogs-user-collection-api-openapi.yml
  - type: Documentation
    url: https://www.discogs.com/developers
  - type: APIReference
    url: https://www.discogs.com/developers
  - type: Authentication
    url: https://www.discogs.com/developers#page:authentication
  - type: TermsOfService
    url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
  - type: SDKs
    url: https://github.com/joalla/discogs_client
  - type: SDKs
    url: https://github.com/jmfontaine/discogs-sdk
  - type: SDKs
    url: https://github.com/andy-miles/discogs-java-client
  - type: SDKs
    url: https://github.com/rock-n-code/discogs-service
  - type: SDKs
    url: https://github.com/discogs/discogs_client
  - type: BulkData
    url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
  - type: GraphQL
    url: graphql/discogs-graphql.md
- aid: discogs:discogs-user-identity-api
  name: Discogs User Identity API
  description: Authenticated user identity, profile, submissions, and contributions.
  humanURL: https://www.discogs.com/developers
  baseURL: https://api.discogs.com
  tags:
  - User Identity
  properties:
  - type: OpenAPI
    url: openapi/discogs-user-identity-api-openapi.yml
  - type: Documentation
    url: https://www.discogs.com/developers
  - type: APIReference
    url: https://www.discogs.com/developers
  - type: Authentication
    url: https://www.discogs.com/developers#page:authentication
  - type: TermsOfService
    url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
  - type: SDKs
    url: https://github.com/joalla/discogs_client
  - type: SDKs
    url: https://github.com/jmfontaine/discogs-sdk
  - type: SDKs
    url: https://github.com/andy-miles/discogs-java-client
  - type: SDKs
    url: https://github.com/rock-n-code/discogs-service
  - type: SDKs
    url: https://github.com/discogs/discogs_client
  - type: BulkData
    url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
  - type: GraphQL
    url: graphql/discogs-graphql.md
- aid: discogs:discogs-user-lists-api
  name: Discogs User Lists API
  description: Browse and manage user-created lists of releases, artists, and labels.
  humanURL: https://www.discogs.com/developers
  baseURL: https://api.discogs.com
  tags:
  - User Lists
  properties:
  - type: OpenAPI
    url: openapi/discogs-user-lists-api-openapi.yml
  - type: Documentation
    url: https://www.discogs.com/developers
  - type: APIReference
    url: https://www.discogs.com/developers
  - type: Authentication
    url: https://www.discogs.com/developers#page:authentication
  - type: TermsOfService
    url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
  - type: SDKs
    url: https://github.com/joalla/discogs_client
  - type: SDKs
    url: https://github.com/jmfontaine/discogs-sdk
  - type: SDKs
    url: https://github.com/andy-miles/discogs-java-client
  - type: SDKs
    url: https://github.com/rock-n-code/discogs-service
  - type: SDKs
    url: https://github.com/discogs/discogs_client
  - type: BulkData
    url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
  - type: GraphQL
    url: graphql/discogs-graphql.md
- aid: discogs:discogs-user-wantlist-api
  name: Discogs User Wantlist API
  description: Manage a user's wantlist.
  humanURL: https://www.discogs.com/developers
  baseURL: https://api.discogs.com
  tags:
  - User Wantlist
  properties:
  - type: OpenAPI
    url: openapi/discogs-user-wantlist-api-openapi.yml
  - type: Documentation
    url: https://www.discogs.com/developers
  - type: APIReference
    url: https://www.discogs.com/developers
  - type: Authentication
    url: https://www.discogs.com/developers#page:authentication
  - type: TermsOfService
    url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
  - type: SDKs
    url: https://github.com/joalla/discogs_client
  - type: SDKs
    url: https://github.com/jmfontaine/discogs-sdk
  - type: SDKs
    url: https://github.com/andy-miles/discogs-java-client
  - type: SDKs
    url: https://github.com/rock-n-code/discogs-service
  - type: SDKs
    url: https://github.com/discogs/discogs_client
  - type: BulkData
    url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
  - type: GraphQL
    url: graphql/discogs-graphql.md
common:
- type: AgenticAccess
  url: agentic-access/discogs-agentic-access.yml
- type: DomainSecurity
  url: security/discogs-domain-security.yml
- type: Authentication
  url: authentication/discogs-authentication.yml
- type: OAuthScopes
  url: scopes/discogs-scopes.yml
- type: Website
  url: https://www.discogs.com
- type: Documentation
  url: https://www.discogs.com/developers
- type: APIReference
  url: https://www.discogs.com/developers
- type: TermsOfService
  url: https://support.discogs.com/hc/articles/360009334593-API-Terms-of-Use
- type: Authentication
  url: https://www.discogs.com/developers#page:authentication
- type: Support
  url: https://support.discogs.com
- type: Forums
  url: https://www.discogs.com/forum/topic/1082
- type: Status
  url: https://status.discogs.com
- type: Blog
  url: https://blog.discogs.com
- type: Plans
  url: plans/discogs-plans-pricing.yml
- type: RateLimits
  url: rate-limits/discogs-rate-limits.yml
- type: GitHubOrganization
  url: https://github.com/discogs
- type: PublicAPIsListing
  url: https://github.com/public-apis/public-apis
- type: BulkData
  title: Monthly XML Data Dumps
  url: https://discogs-data-dumps.s3.us-west-2.amazonaws.com/index.html
- type: Tools
  title: MCP Server (cswkim)
  url: https://github.com/cswkim/discogs-mcp-server
- type: Tools
  title: MCP Server (rianvdm OAuth)
  url: https://github.com/rianvdm/discogs-mcp
- type: Tools
  title: MCP Server (pipeworx-io)
  url: https://github.com/pipeworx-io/mcp-discogs
- type: Tools
  title: MCP Server (andylobban Self-hostable)
  url: https://github.com/andylobban/discogs-mcp-server
- type: Tools
  title: MCP Server (leosakharoff)
  url: https://github.com/leosakharoff/discogs-mcp
- type: Vocabulary
  url: vocabulary/discogs-vocabulary.yml
- type: SpectralRuleset
  url: rules/discogs-rules.yml
- type: JSONLDContext
  url: json-ld/discogs-context.jsonld
features:
- name: Database Search
  description: Free-text search across releases, masters, artists, and labels with rich filters (year, country, format, label,
    genre, style, barcode, catno).
- name: Release Catalog
  description: Detailed release records including tracks, formats, labels, artists, videos, identifiers, community stats,
    and marketplace stats.
- name: User Collection Management
  description: Read and modify user record collections, organized into custom folders with notes and rating per copy.
- name: User Wantlist
  description: Track wanted releases, with notes and ratings; add and remove releases programmatically.
- name: Marketplace Listings
  description: List, update, and delete records for sale; query inventory by username; integrate with checkout flows via the
    Listing endpoints.
- name: Marketplace Orders
  description: Inspect, update, and message on orders the authenticated seller has received.
- name: Price Suggestions
  description: Get Discogs-calculated suggested marketplace prices by release and media condition.
- name: Bulk Inventory Management
  description: CSV-driven bulk add, change, and delete of inventory listings via asynchronous upload jobs; full inventory
    export to CSV.
- name: OAuth 1.0a
  description: Three-legged OAuth 1.0a flow for building third-party apps that act on behalf of other Discogs users.
- name: Monthly XML Data Dumps
  description: Discogs publishes a monthly snapshot of the full database (artists, labels, masters, releases) as XML on S3
    for bulk analysis.
useCases:
- name: Music Discovery Apps
  description: Build apps that surface release metadata, cover art, video links, community ratings, and label discographies.
- name: Vinyl Reseller Tools
  description: Power inventory management, pricing, and order workflows for vinyl resellers selling on the Discogs Marketplace.
- name: Collection Trackers
  description: Mobile and desktop apps that sync a collector's Discogs collection and wantlist offline.
- name: Catalog Enrichment
  description: Enrich third-party music libraries (DJ tools, archive systems, streaming metadata) with Discogs identifiers,
    formats, and release dates.
- name: AI Music Agents
  description: Power LLM-driven shopping, discovery, and collection-management agents via the Discogs MCP server ecosystem.
- name: Research and Analytics
  description: Use the monthly XML data dumps for population-level analysis of pressing variants, label catalogs, and marketplace
    pricing.
integrations:
- name: OAuth 1.0a
  description: Standards-compliant OAuth 1.0a for delegated user authorization.
- name: CSV
  description: Bulk inventory imports and exports use CSV files.
- name: Microcks
  description: OpenAPI spec is annotated with x-microcks-operation extensions for mock-server compatibility.
- name: Model Context Protocol
  description: Five plus community MCP servers expose Discogs surfaces (search, collection, wantlist, marketplace) as MCP
    tools for LLM agents.
solutions:
- name: Marketplace Storefront Sync
  description: Combine inventory upload, order management, and price suggestions to operate a multi-channel record store with
    Discogs as inventory of record.
- name: Collector Mobile Companion
  description: Combine identity, collection, wantlist, and search to build a fully-featured mobile companion for record collectors.
- name: Catalog Resolution Service
  description: Use search and release endpoints to resolve fuzzy track metadata into canonical Discogs IDs and master release
    versions.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com