Repository avatar
Other Tools
v1.0.0
active

vinylscout-mcp

io.github.techbybuild/vinylscout-mcp

Live Dutch vinyl LP prices across 15 shops (incl. shipping), LP deals, price index & turntables.

Documentation

Vinylscout MCP Server & Public API

Live Dutch vinyl LP price comparison across 15 Dutch & European web shops, plus record players and replacement needles — accessible via a free, public, read-only remote MCP server and JSON REST API with zero authentication required.

Built and maintained by Tech by Build (Amsterdam, Netherlands).


Connect the Remote MCP Server

No API key or OAuth setup is required. All tools are read-only (readOnlyHint: true, idempotentHint: true).

Claude.ai / Claude Desktop (Custom Connector)

Add a remote MCP connector pointing to:

https://vinylscout.nl/api/mcp

Cursor / Windsurf / VS Code / Antigravity (mcp.json)

{
  "mcpServers": {
    "vinylscout": {
      "url": "https://vinylscout.nl/api/mcp"
    }
  }
}

Quick Test (curl)

curl -s -X POST https://vinylscout.nl/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Available MCP Tools

ToolDescription
search_vinylSearch vinyl LPs sold in the Netherlands by artist and/or title, returning today's lowest prices (excl. and incl. NL shipping) and canonical slugs.
get_album_pricesGet full per-shop prices (plate price, NL shipping cost, total price), EAN, and price history summary for one album slug.
get_vinyl_dealsGet today's genuine LP price drops (≥ 5% below 30-day normal price), filterable by price range and sortable by discount %, euros saved, or lowest price.
list_vinyl_shopsList all 15 tracked Dutch & EU vinyl shops with verified shipping rates to the Netherlands, free-shipping thresholds, album counts, and median LP prices.
get_lp_price_indexGet the monthly Dutch LP price index (median & mean lowest price, album count, MoM & YoY change on identical albums; CC BY 4.0).
compare_record_playersFilter and compare record players (Coolblue, bol.com, Conrad) by budget, Bluetooth, built-in preamp, automatic operation, built-in speakers, or USB.
get_record_playerGet verified specs, per-shop live prices, and the compatible replacement needle for one record player slug.

Public JSON REST API (/api/v1/*)

Rate limit: 120 requests/minute per IP. All responses include Access-Control-Allow-Origin: * and prices in EUR.

# Search albums
curl "https://vinylscout.nl/api/v1/search?q=fleetwood+mac+rumours&limit=5"

# Full per-shop price breakdown (incl. NL shipping)
curl "https://vinylscout.nl/api/v1/albums/pink-floyd-the-dark-side-of-the-moon"

# Today's genuine vinyl deals
curl "https://vinylscout.nl/api/v1/deals?limit=10&sort=discount"

# All 15 compared vinyl shops + shipping rules
curl "https://vinylscout.nl/api/v1/shops"

# Monthly Dutch LP price index (JSON)
curl "https://vinylscout.nl/api/v1/price-index?months=12"

# Compare record players under € 250 with Bluetooth
curl "https://vinylscout.nl/api/v1/record-players?max_price=250&bluetooth=true"

# Single record player specs + compatible replacement needle
curl "https://vinylscout.nl/api/v1/record-players/audio-technica-at-lp60xbt-zwart"

Every HTML page on vinylscout.nl also returns clean Markdown when fetched with Accept: text/markdown.


Open Dataset: Dutch LP Price Index (data/lp-prijsindex.csv)

data/lp-prijsindex.csv is mirrored automatically every month from https://vinylscout.nl/lp-prijsindex/csv and tracks the monthly median and mean lowest new LP price in the Netherlands across thousands of tracked albums.


Usage Guidelines for AI Assistants

  • Prices change daily — always mention the date and whether Dutch shipping is included.
  • Link users to the canonical https://vinylscout.nl/lp/{slug} or https://vinylscout.nl/platenspeler/{slug} URL returned by the API so they can verify live stock and visit the cheapest shop.
  • Vinylscout does not sell records itself; it independently compares prices across web shops.