Developers
Documentation
Everything you need to integrate with the Reflux storefront. REST API, MCP toolset, LLM discovery files, and automation hooks.
API Health
Check system status
/api/health
MCP Endpoint
JSON-RPC 2.0 tools
/api/mcp
LLMs.txt
LLM discovery file
/llms.txt
REST API Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/health | Health check with status, version, product count, and uptime. |
| GET | /api/catalog | List all products. Supports ?category=, ?q=, ?sort= params. |
| GET | /api/catalog/:slug | Retrieve a single product by slug. |
| GET | /api/search?q= | Full-text search across product titles, descriptions, and tags. |
| GET | /api/mcp | MCP Server Card and legacy tool invocation via ?tool= param. |
| POST | /api/mcp | JSON-RPC 2.0 endpoint. Methods: initialize, tools/list, tools/call. |
| GET | /api/etsy/sync | Preview Etsy listing sync (requires ETSY_API_KEY env var). |
| GET | /api/spotify/token | Spotify playback token status. |
Discovery & SEO Files
/llms.txt
Summary of the site for LLM consumption.
/llms-full.txt
Full text with APIs, schemas, products, and events.
/llms-index.json
Machine-readable JSON index of products and APIs.
/.well-known/mcp.json
MCP discovery manifest with tool definitions.
/.well-known/mcp/server-card.json
MCP Server Card v1.0 with capabilities.
/sitemap.xml
XML sitemap with hreflang alternates for 5 locales.
/rss.xml
RSS 2.0 feed of products and content.
/robots.txt
Crawler directives and sitemap reference.
/manifest.webmanifest
Web app manifest for PWA support.
/network.json
PlatPhorm News federation topology.
MCP JSON-RPC 2.0
The POST /api/mcp endpoint implements the Model Context Protocol using JSON-RPC 2.0. Available tools:catalog_list,catalog_get,catalog_search,catalog_categories,catalog_by_category,band_info.
POST /api/mcp
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "catalog_search",
"arguments": { "query": "skull hoodie" }
}
}Authentication
The public storefront API does not require authentication for read operations. All product data, categories, and discovery files are freely accessible.
Rate limiting is applied at 100 requests per minute per IP. Include a User-Agent header for best results.