get_cover_art_urls
Retrieve cover art image URLs for music releases from the Cover Art Archive. Provide a release ID to get front/back covers and thumbnails for specific album editions.
Instructions
Get cover art image URLs for a specific release (edition) from the Cover Art Archive. Takes a release_id, NOT a release_group_id. Returns URLs for front/back covers and thumbnails.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| release_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- mcp_musicbrainz/server.py:742-766 (handler)The tool `get_cover_art_urls` handler implemented in `server.py` using `musicbrainzngs` to fetch cover art.
@mcp.tool() @cached_tool() def get_cover_art_urls(release_id: str) -> str: """Get cover art image URLs for a specific release (edition) from the Cover Art Archive. Takes a release_id, NOT a release_group_id. Returns URLs for front/back covers and thumbnails.""" images = musicbrainzngs.get_image_list(release_id) img_list = images.get("images", []) if not img_list: return "No cover art images available." lines = [f"Cover art for release {release_id} ({len(img_list)} images):"] for img in img_list: types = ", ".join(img.get("types", ["Unknown"])) lines.append(f"- [{types}] {img.get('image', 'N/A')}") thumbs = img.get("thumbnails", {}) if thumbs: thumb_url = thumbs.get("500") or thumbs.get("large", "") if thumb_url: lines.append(f" Thumbnail: {thumb_url}") return "\n".join(lines) @mcp.tool() @cached_tool()