Base URL
/v1. The MCP server for agents is at /mcp (Connect an agent).
Authentication
None needed. Every endpoint, including the MCP server, works without a key or sign-up:Authorization: Bearer ov_live_.... Keys go in headers only, never in the URL.
Rate limits
The API is free. Limits are only there to keep it fair:
The per-minute limit refills evenly, so short bursts are fine; the daily limit resets at 00:00 UTC. Every response tells you where you stand:
GET /v1/me returns your current limits.
Conventions
- IDs. Albums are
m…,g…orr…(see Albums and pressings). Pressings use the Discogs release ID. - Codes as printed. Barcodes, catalog numbers and runouts can be sent exactly as they appear on the record. Spaces, dashes and case are ignored.
- Album first. Lookups return albums. Pressings are included where they matched, and can be ignored.
- Provenance. Values carry their source. Derived values carry their rule and confidence.
Errors
Errors return a JSON body with
detail: