ListenBrainz
ListenBrainz · Music, books and games
ListenBrainz: listening history, submitting listens and stats
The client pastes their user token from ListenBrainz's settings. We store it encrypted.
Tested against ListenBrainz's live API.
Building with ListenBrainz? The docs have setup steps and code for every tool.
Open the ListenBrainz docsTools
Your agent calls any endpoint of ListenBrainz's API with the request tool, with the client's access attached.
Base URL for request
https://api.listenbrainz.org/1
request
HTTPS ANY /v1/clients/{clientId}/listenbrainz/{path}
Any endpoint of ListenBrainz's own API, with the client's access attached.
- servicestringrequired
- This service: listenbrainz
- methodstringrequired
- GET, POST, PUT, PATCH or DELETE
- pathstringrequired
- The path under https://api.listenbrainz.org/1
- queryobjectoptional
- Query parameters
- bodyobjectoptional
- A JSON body
Over MCP every tool also takes client_id, from list_clients. Over HTTPS send it as clientId to https://api.operate.as/v1.
What the client approves
- Use the ListenBrainz key you paste, with only the access you gave that key
Get started
Send your next client one link
Add a client, select the services, copy the link. You'll get an email the moment their access is ready. Start free, no card required. Paid plans are one flat monthly price, and a busy month never takes your agents offline.