DevelopKerr

> ./blog / soundsfound-mcp

I Added MCP Support to soundsfound

#soundsfound 3 min read
A robot browsing a rack of vinyl records in a record shop

soundsfound is the site I built to search independent record shops in one go, instead of opening tab after tab. I wrote about that at launch in Meet soundsfound: one search for independent record shops.

Agents could already run that search in a browser, through WebMCP tools on the site itself. Useful, but you have to have the site open.

That’s why I added an MCP server to soundsfound. I think more and more shopping will be completed by agents, and while the stores may not support agent purchase yet, you can at least find records using an agent. You can set up scheduled tasks and have your agent comb for all of the records you’re after, or the one record you’re desperate to add to your collection. The same three tools are now served by the API at /mcp, so any MCP client can look up artists, search the shops for a record and collect the listings as each shop answers, without the site open.

What the tools do

There are three of them: lookup_artists_and_titles, search_records and get_record_search_results.

lookup_artists_and_titles turns partial text into matching artists and titles, so you don’t need the exact name before you start.

search_records returns any listings already stored and starts a search across the shops. If nothing is stored yet, it waits until the first shop reports a listing, the search finishes, or twenty seconds have passed, whichever comes first.

get_record_search_results returns the listings collected so far for that search. The usual path is to look up the artist or title, start the search, then keep asking for results while shops are still answering.

You can still search the shops on soundsfound in the browser, as before.

How to connect

Add https://api.soundsfound.com/mcp as a remote MCP server in your MCP client. Read the connection guide on soundsfound for the steps.

A few limits

search_records is not a read-only lookup. It contacts the shops and saves what they return, so new searches started over MCP are limited to five a minute in total, not per client. Once that limit is reached, the tool still returns any listings already stored, but it will not start another search until that minute has passed.

Results from a search do not hang around forever. After a restart, or ten minutes after a search completes, you need to start a new one.

The /mcp endpoint has no authentication, which is also true of the rest of the API. Adding authentication, and a per-client rate limit, is still open work.

Where I’m heading

The next big thing will be the ability to create a (free) account. Once that is established, you will be able to create a wishlist and have your agent wishlist records for you, or search for your wishlist. You will be able to review records you own, log your existing collection, favourite a store and get notified when a specific record is in stock.

I also plan to add a blog section to soundsfound, with cross-posts of the relevant DevelopKerr pieces and anything unique to soundsfound.

Let me know your thoughts below. Which record is the first one you’re going to have your agent hunting for?

Get in touch