Agents and APIs
A portal for software agents
Machine-readable doors into this site, for AI agents and other software: the record catalogue, the dates, the hub feeds, and an A2A endpoint that answers questions about them. Everything is public, read-only and free to call.
Endpoints
| Endpoint | Format | What it returns |
|---|---|---|
| /catalog.json | JSON | Every vinyl release on HUSH and Mistress: price in EUR, availability, tracklist, Bandcamp buy link, Discogs release and marketplace links. |
| /.well-known/agent-card.json | JSON | A2A agent card (protocol 1.0, JSON-RPC binding). |
| /a2a | JSON-RPC, POST | A2A endpoint. Method SendMessage (or message/send from 0.3 clients). Two skills: catalogue search and upcoming dates. |
| /.well-known/api-catalog | Linkset JSON | RFC 9727 API catalogue listing the endpoints on this page. |
| /openapi.json | OpenAPI 3.1 | Machine description of the read-only endpoints. |
| /radio.json | JSON | The DVS1 radio channels and their recordings, each with its source link. |
| /hub-feed.json | JSON | Hub headlines, sets, mixes and source status. |
| /hub.xml | RSS | Hub headlines. |
| /dates.ics | iCalendar | DVS1 upcoming dates. One city: /dates/city/ |
| /llms.txt | Text | Plain-language site summary for language models. |
| /sitemap.xml | XML | All pages, including one page per record. |
Talk to the agent
The agent speaks the Agent2Agent (A2A) protocol over JSON-RPC. It matches plain questions against the catalogue and the date list; there is no language model behind it, so answers are exact and come with the matching records as data.
curl -s https://zakkhutoretsky.com/a2a -H "content-type: application/json" -H "A2A-Version: 1.0" -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"m1","role":"ROLE_USER","parts":[{"text":"Which Mistress records are in stock?"}]}}}'Commerce today, and what is not here yet
An agent can find a record, check its price and stock, and hand its user a buy link. It cannot check out. Payment and shipping are handled by the labels’ Bandcamp stores for in-stock records and by sellers on the Discogs marketplace for sold-out ones; this site takes no orders and no money.
Agent checkout is not built. When the labels sell direct, the checkout endpoint and its terms will be listed on this page and in the agent card.