# WAXED — waxed.market

> WAXED is a vinyl-record marketplace and music catalog: dealers run storefronts,
> collectors buy records, and every release is backed by structured catalog data
> (pressings, genres, cover art), real sales-price history, and price estimates.

## For AI agents

- MCP server (Model Context Protocol, Streamable HTTP). Canonical: the bare
  host https://mcp.waxed.market (middleware rewrites `/` and `/mcp` to the
  route below). Also still supported unchanged: POST https://waxed.market/api/mcp
  43 tools total (14 read + 29 dealer/write).
  Catalog & market (14, no auth): search, get_release, browse_marketplace,
  get_price_estimate, get_price_history, get_store, get_shared_wishlist,
  get_artist, get_label, get_crate, discogs_search, lookup_barcode,
  get_shipping_quote, create_checkout_link.
  Inventory (6, agent key): my_listings, create_listing, update_listing,
  set_listing_status, delete_listing, bulk_update_listings.
  Crates (6, agent key): my_crates, create_crate, update_crate, delete_crate,
  modify_crate_items, publish_crate.
  Integrations (5, agent key): discogs_sync, discogs_status, discogs_pause,
  square_status, square_push.
  Orders (3, agent key): my_orders, get_order, update_order_status.
  Analytics & profile (5, agent key): my_analytics, hot_items, market_trends,
  my_profile, update_profile.
  Messaging (3, agent key): my_conversations, get_conversation, send_message.
  Shipping (1, agent key): get_order_shipping_rates.
  Writes require a dealer agent key (waxed.market → Settings → Developer,
  sent as `Authorization: Bearer wxk_…`); no payment/refund capability exists over MCP.
  Clients that support OAuth 2.1 (dynamic client registration + PKCE) can
  connect without a manual key instead — discover
  /.well-known/oauth-protected-resource.
  Square pull sync, Discogs price-sync, and bulk delete are not exposed over MCP
  (bulk_update_listings has no delete action; use delete_listing per item).
  Every tool carries MCP annotations (title + read-only/destructive/idempotent
  hints). Read-tool results for releases, listings, stores, crates, artists,
  and labels include an absolute `url` field (see Pages below); get_release,
  get_store, get_crate, get_artist, and get_label also return a resource_link
  content item pointing at the primary entity's page.

## Public JSON API (no auth)

- GET /api/search/unified?q={query} — search records, artists, stores, labels, genres
- GET /api/marketplace/discover?genre=&format=&sort=&page= — browse active listings (48/page)
- GET /api/marketplace/release/{release_id}/master — release detail, versions, copies for sale
- GET /api/pricing/estimate/{release_id}?condition=1-5&country=XX — market price estimate (USD)
- GET /api/gripsweat/history/{release_id}?mode=exact|all_versions — historical sales
- GET /api/stores/{slug}?limit=&offset= — dealer storefront profile + active listings
- GET /api/wishlist/{token} — a publicly shared want-list
- GET /api/artists/{name}?limit= — artist page: bio, discography, active listings
- GET /api/labels/{name}?limit= — label page: profile, sublabels, discography, active listings
- GET /api/marketplace/crates/{id} — dealer-curated crate bundle detail (full item list)

Prices in listing/storefront/release responses are USD cents unless a field is
explicitly named price_usd.

## Pages

- /release/{release_id} — release pages carry schema.org Product + AggregateOffer JSON-LD
- /users/{slug} — dealer storefronts (/stores/{slug} 301s here)
- /marketplace — main marketplace UI
- /marketplace/artists/{name} — artist page (bio, discography, active listings)
- /marketplace/labels/{name} — label page (profile, sublabels, discography, active listings)
- /genre/{slug} — genre browse page
- /crates/{id} — crate bundle permalink page
- /compare/discogs — WAXED vs Discogs: seller fees (8% of item price vs Discogs' 9% of item + shipping), price data, storefronts, POS/inventory sync, crates, agent access, and what Discogs is better at. Carries schema.org FAQPage JSON-LD; Discogs figures cited to Discogs' own help pages with a retrieval date
- /trends — vinyl market statistics: median/quartile asking prices, price distribution, medians by genre and format, median sold price. Computed hourly from live WAXED data; carries schema.org Dataset JSON-LD and is free to quote with attribution
- /sitemap.xml — releases with active listings + storefronts