lookup_by_barcode
Find music releases using UPC/EAN barcode numbers to retrieve detailed metadata from the MusicBrainz database.
Instructions
Finds a release by its UPC/EAN barcode.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| barcode | Yes |
Implementation Reference
- mcp_musicbrainz/server.py:659-672 (handler)The lookup_by_barcode tool is defined in mcp_musicbrainz/server.py, decorated with @mcp.tool() and @cached_tool(). It searches MusicBrainz for releases matching the provided barcode and formats the results.
@mcp.tool() @cached_tool() def lookup_by_barcode(barcode: str) -> str: """Finds a release by its UPC/EAN barcode.""" result = musicbrainzngs.search_releases(barcode=barcode, limit=5) releases = result.get("release-list", []) if not releases: return f"No releases found for barcode {barcode}." lines = [f"Releases for barcode {barcode}:"] for r in releases: artist = r.get("artist-credit-phrase", "Unknown") date = r.get("date", "?") lines.append(f"- {r['title']} by {artist} ({date}) | release ID: {r['id']}") return "\n".join(lines)