Skip to main content
Glama

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"}'

Related MCP server: PrijsProfeet MCP

Available MCP Tools

Tool

Description

search_vinyl

Search 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_prices

Get full per-shop prices (plate price, NL shipping cost, total price), EAN, and price history summary for one album slug.

get_vinyl_deals

Get 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_shops

List 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_index

Get the monthly Dutch LP price index (median & mean lowest price, album count, MoM & YoY change on identical albums; CC BY 4.0).

compare_record_players

Filter and compare record players (Coolblue, bol.com, Conrad) by budget, Bluetooth, built-in preamp, automatic operation, built-in speakers, or USB.

get_record_player

Get 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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables product search, price comparison, and price history analysis across 6 European marketplaces (DE, AT, GB, FR, IT, ES).
      28
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables querying live offers and prices from 10 Dutch supermarket chains through a single normalised JSON API. Exposes 26 curated tools, including product search and category lookups, over stdio or authenticated Streamable HTTP.
      20
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to search and read a Dutch web shop's public product catalog, variants, CMS pages, blog posts, merchant profile, and contact details through read-only MCP tools.
      MIT