SupplyClub Developer & Agent Resources

SupplyClub is a B2B wholesale supplier of eco-friendly foodservice packaging and restaurant supplies. We serve restaurants, hotels, hospitals, caterers, coffee shops, schools, event venues, and corporate dining across the United States.

We buy through a network of manufacturing and distribution partners in the United States and overseas, and price cost-plus: you see the landed cost and the margin on it. No order minimums on stock items. Members pay less and ship free.

We are an AI-native distributor. Traditional foodservice distribution runs on phone calls, PDF price lists, and rep relationships; we build our own technology into it instead. Live pricing, the full catalog, and product data are open to people and to AI agents through the same public interfaces — a read-only MCP server and a REST API, no authentication required.

Everything below is public and read-only. No API key or authentication is required. Catalog reads are rate-limited to 60 requests per minute per IP; verified crawlers are exempt.

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"

Contact

Questions about the API or agent access? Email [email protected] or use the contact form.