# REFLUX Official Merch Store - LLM Entry Points
# https://reflux.platphormnews.com
# Etsy Store: https://www.etsy.com/shop/REFLUXStore
# MCP Hub: https://mcp.platphormnews.com

> Reflux was a progressive metalcore band from Washington, D.C. (2000-2006).
> Founded by Ash Avildsen (vocals) and Tosin Abasi (guitar). Original lineup included co-vocalist John Mehoves, bassist Evan Brewer, and drummer Dave Lozano.
> Album lineup: Avildsen, Abasi, Brewer, Vincent Vinh (drums), with Chris Dowhan (keyboards). All lyrics by Avildsen & Mehoves.
> Post-breakup: Abasi founded Animals as Leaders, Avildsen founded Sumerian Records, Brewer joined The Faceless/Fallujah/Look What I Did.
> Album: The Illusion of Democracy (Prosthetic Records, 2004).
> This storefront sells official band merchandise via Etsy.
> The site supports 5 locales: en (default), es, fr, de, ja. All pages are under /{lang}/ paths.

## API Surfaces

- [Product Catalog API](https://reflux.platphormnews.com/api/catalog): GET - Returns all products with optional query, category, and sort params.
- [Product Detail API](https://reflux.platphormnews.com/api/catalog/{slug}): GET - Returns a single product by slug.
- [Search API](https://reflux.platphormnews.com/api/search?query={keyword}): GET - Full-text search over titles, descriptions, and tags.
- [MCP Endpoint](https://reflux.platphormnews.com/api/mcp): POST (JSON-RPC 2.0) - MCP tools. GET returns server card.
- [MCP Server Card](https://reflux.platphormnews.com/.well-known/mcp/server-card.json): MCP Server Card v1.0 specification.
- [Health Check](https://reflux.platphormnews.com/api/health): GET - Service status, catalog stats, and endpoint inventory.
- [Etsy Sync](https://reflux.platphormnews.com/api/etsy/sync): GET - Preview Etsy listing sync (requires ETSY_API_KEY).
- [Spotify Token](https://reflux.platphormnews.com/api/spotify/token): GET - Spotify playback token status.

## Human Pages (localized: /en/, /es/, /fr/, /de/, /ja/)

- [Landing Page](https://reflux.platphormnews.com/en): Hero, featured merch, album info, band story, and Etsy CTA.
- [Shop](https://reflux.platphormnews.com/en/shop): Full product catalog with category filters and search.
- [Product Detail](https://reflux.platphormnews.com/en/shop/{slug}): Individual product page with pricing, tags, and Buy on Etsy link.
- [Music](https://reflux.platphormnews.com/en/music): Album page with Spotify Web Playback SDK, tracklist, personnel, and reviews.
- [Story](https://reflux.platphormnews.com/en/story): Band history timeline from formation through dissolution and legacy.
- [Docs](https://reflux.platphormnews.com/en/docs): Developer documentation for API, MCP, schema, and automation hooks.

## Discovery & Feeds

- [llms-full.txt](https://reflux.platphormnews.com/llms-full.txt): Extended index with complete product catalog, schema, and integration details.
- [llms-index.json](https://reflux.platphormnews.com/llms-index.json): Machine-parseable JSON inventory of all entry points and products.
- [Sitemap](https://reflux.platphormnews.com/sitemap.xml): XML sitemap with hreflang alternates for all 5 locales.
- [RSS Feed](https://reflux.platphormnews.com/rss.xml): RSS feed of all products.
- [robots.txt](https://reflux.platphormnews.com/robots.txt): Crawler directives.
- [Web Manifest](https://reflux.platphormnews.com/manifest.webmanifest): PWA manifest.

## MCP Integration (v2.0 - JSON-RPC 2.0)

- MCP Hub: https://mcp.platphormnews.com
- Local endpoint: https://reflux.platphormnews.com/api/mcp (POST for JSON-RPC, GET for server card)
- Server Card: https://reflux.platphormnews.com/.well-known/mcp/server-card.json
- Well-known: https://reflux.platphormnews.com/.well-known/mcp.json
- Protocol version: 2024-11-05
- Tools: catalog_list, catalog_get, catalog_search, catalog_categories, catalog_by_category, band_info

### JSON-RPC Invocation

POST /api/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"catalog_search","arguments":{"query":"skull hoodie"}}}

## Internationalization

Supported locales: en (English, default), es (Spanish), fr (French), de (German), ja (Japanese).
Locale detection: Accept-Language header negotiation with cookie override.
URL structure: /{lang}/page (e.g., /es/shop, /ja/music).
Hreflang alternates included in sitemap.xml.

## Spotify Integration

The music page includes a Spotify Web Playback SDK player with PKCE OAuth flow.
When Spotify credentials are not configured, it falls back to an iframe embed.
Connect flow: GET /api/spotify/authorize -> Spotify OAuth -> callback -> Web Playback SDK.

## External Links

- Etsy Store: https://www.etsy.com/shop/REFLUXStore
- PlatPhorm News Network: https://platphormnews.com
- MCP Hub: https://mcp.platphormnews.com
- Coinbase: 0x30589F2e1B8E9a48BBb2c66Ac012FE7ED2A7eB85

## Conventions

All API endpoints return JSON with UTF-8 encoding. CORS is enabled for all /api/* routes (GET and POST).
Responses include Cache-Control headers. Product purchases redirect to Etsy listings.
Agents should respect robots.txt and sitemap.xml for crawl guidance.
JSON-LD schemas (Organization, MusicGroup, MusicAlbum, Product, FAQPage, BreadcrumbList, ItemList, SiteNavigationElement) are embedded in every page.