Song registration check: MLC registration, unclaimed shares, writers, publishers and ISWCs
lookup_recordingISRC lookup and music royalties registration check for one recording, with the song's rights data. Give exactly one of: an ISRC, a Spotify track link, a song title (optionally with the artist), or a YouTube link. Returns candidate recordings and MLC works, how each was matched and how confidently, and a verdict per recording: registered, partial (a share is unclaimed), nobody (no MLC work is linked), conflict, missing_from_bulk (an earlier copy of The MLC's bulk data showed publishers or a work link that the current copy does not; the bulk data has dropped claims that are still live, so never a finding that a share is unclaimed), or unknown. Each verdict carries dated evidence (as_of, from The MLC's bulk data snapshot) and a factual next step. Also returns what MusicBrainz records for the recording: the linked works with their ISWCs, the writers and publishers with their IPI and ISNI numbers, the earliest release's album, date, label and catalogue number, and the MusicBrainz page. With full_record true it adds every release (label, catalogue number, country and date), performer and producer credits and related recordings; that answer is many times larger. When several matches are equally likely, ambiguous is true and all are returned. Findings from registration data, not legal advice or a statement of song ownership.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "lookup_recording"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| isrc | No | ISRC, 12 characters, e.g. USIR20400274 (hyphens and spaces allowed). | |
| title | No | Song title, when no ISRC or link is available. | |
| artist | No | Optional artist name; only together with title. | |
| full_record | No | True to add MusicBrainz's full record of the recording: every release with its label, catalogue number, country and date, the credits, and related recordings. Only for an ISRC or a Spotify link that resolves to one recording. Leave it out unless that detail is needed: the answer is many times larger. | |
| spotify_url | No | Spotify track link (https://open.spotify.com/track/...) or spotify:track:... URI. Album and playlist links are not accepted. | |
| youtube_url | No | YouTube video link; resolved from the video title, so matches are low confidence. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | ||
| query | Yes | ||
| results | No | ||
| ambiguous | No | ||
| candidates | No | ||
| input_kind | Yes | ||
| mlc_source | No |