SupplyClub Developer & Agent Resources

Interfaces

• /api/mcp

  MCP server (protocol 2025-11-25, Streamable HTTP). Tools: search_products (search with brand, material, category, and price filters, paging, and price sorting) and get_product (full detail by slug).

• /.well-known/mcp.json

  MCP server card describing the endpoint and its tools.

• /openapi.json

  OpenAPI 3.1 spec for the public REST read endpoints, including the shared JSON error envelope.

• /llms.txt

  Machine-readable site index: catalog summary, key pages, and agent access points.

REST endpoints

• GET /api/products/by-ids?ids=123,456

  Fetch full product data for a list of WooCommerce product IDs (max 100 per request).

• POST /api/pricing/get-prices-for-products

  Calculate guest or member prices for a list of products.

Product IDs are numeric WooCommerce IDs. Get them from the MCP tools (search_products / get_product), which return each product's product_id alongside its /product/{slug} page URL. Public product pages expose the slug, SKU, and GTIN, not the numeric ID.

Conventions

• Product pages live at https://mysupplyclub.com/product/{slug} and are server-rendered with Product, Offer, and Breadcrumb JSON-LD.
• Content pages (product, category, knowledge-base article, glossary term, and the homepage) return clean Markdown from the same URL when the request sends Accept: text/markdown (Vary: Accept, q-values honored).
• Every API error returns the same JSON envelope: { "error": { "code", "message", "hint" } }. Unmatched /api/* paths return a 404 with this shape, never HTML.

Quickstart

# Fetch a product as Markdown
curl -H "Accept: text/markdown" https://mysupplyclub.com/product/{slug}

# Look up products by ID (JSON)
curl "https://mysupplyclub.com/api/products/by-ids?ids=123,456"