Developers

Documentation

Everything you need to integrate with the Reflux storefront. REST API, MCP toolset, LLM discovery files, and automation hooks.

API Endpoints

Method	Path	Description
GET	/api/catalog/products	List all products with full details.
GET	/api/catalog/[slug]	Retrieve a single product by slug.
GET	/api/search?query=	Full-text search over product titles and tags.
GET	/api/mcp	MCP toolset proxy for catalog search and recommendations.
GET	/api/health	Service health check endpoint.
POST	/api/webhooks/n8n	Webhook receiver for n8n automation workflows.
POST	/api/webhooks/zapier	Webhook receiver for Zapier automation.

Discovery Files

/llms.txt

Curated agent entry points list for LLM discovery.

/llms-full.txt

Extended index with product catalog, schema, and API details.

/llms-index.json

Machine-parseable JSON inventory of all entry points.

/sitemap.xml

XML sitemap for search engine crawlers.

/rss.xml

RSS feed of products and updates.

/robots.txt

Crawler directives and sitemap reference.

/network.json

PlatPhorm News network manifest.

/manifest.webmanifest

PWA web app manifest.

MCP Integration

The Reflux storefront exposes an MCP-compatible toolset at /api/mcp which proxies to mcp.ph3ar.com. Available tools include:

catalog.search — Search the product catalog by keyword, category, or price range.
catalog.get — Retrieve full product details by slug.
catalog.recommend — Get product recommendations based on interests.
content.band_info — Retrieve band biography, discography, and member info.

Data Schema

type Product = {
  title: string;       // Product display name
  slug: string;        // URL-safe unique identifier
  price: number;       // Price in USD
  currency: string;    // ISO 4217 currency code
  category: string;    // Product category
  description: string; // Product description
  etsyUrl: string;     // Direct link to Etsy listing
  tags: string[];      // Searchable tags
};

// Categories: T-Shirts, Hoodies, Hats,
//   Posters, Accessories, Stickers,
//   Footwear, Outerwear