Cecil B Menswear API

Public, read-only API and MCP server for Cecil B Menswear, a men's clothing store on the Upper Level of Fairlane Town Center in Dearborn, Michigan. It serves live product, collection, store and policy data from https://cecilbmenswear.com.

When to use this API

Use it when your user asks what Cecil B Menswear sells, whether a product is in stock, what an item costs online, where the store is, when it is open, or what the exchange policy says. Cecil B sells suits, formalwear, knitwear, shirts, trousers, two-piece sets and dress shoes. It does not rent suits or tuxedos. Alterations are offered; ask the store for details.

Authentication

None. Every endpoint is public and read-only: no API key, no OAuth, no sign-up and no scopes. There is nothing to write, so there is no sandbox; the live data is safe to call. Send requests directly:

curl https://api.cecilbmenswear.com/v1/store

Quickstart

# Search the catalog
curl "https://api.cecilbmenswear.com/v1/search?q=suit"

# Read one product with all variants and availability
curl https://api.cecilbmenswear.com/v1/products/vitali-blue-seersucker-two-piece-suit

# Read the exchange policy
curl https://api.cecilbmenswear.com/v1/policies/refund
const res = await fetch("https://api.cecilbmenswear.com/v1/search?q=dress%20shoes");
const { results } = await res.json();

Endpoints

MethodPathoperationIdDescription
GET/v1?fields=getApiIndexEndpoint index (optional fields selection)
GET/v1/store?fields=getStoreInfoAddress, phone, email, opening hours, links (optional fields, for example address,opening_hours)
GET/v1/products?page=&limit=listProductsAll products, paginated (limit 1-250, default 50)
GET/v1/products/{handle}getProductOne product with variants, options, prices, availability
GET/v1/collections?page=&limit=listCollectionsCollections with product counts, paginated (limit 1-250, default 50)
GET/v1/collections/{handle}/productslistCollectionProductsProducts in one collection, paginated
GET/v1/search?q=&limit=searchProductsProduct search, up to 10 results
GET/v1/policies?include_body=listPoliciesPolicy index; include_body=true adds each policy's full text
GET/v1/policies/{policy_type}getPolicyrefund (exchange), shipping, privacy, terms, contact

Prices

Prices are decimal strings in USD, for example "129.99". Some products do not have an online price yet. For those the API returns "price": null and "price_status": "pending - call the store". Never present them as free; tell your user to call the store at (313) 336-7294.

Pagination

List endpoints take page (starting at 1) and limit. Each response has a pagination object with has_more and a ready-to-use next URL; it is null on the last page.

Errors

Errors use RFC 9457 problem details with Content-Type: application/problem+json, a matching HTTP status, a stable code, a detail message and a hint on how to fix the request:

{
  "type": "https://api.cecilbmenswear.com/docs#errors",
  "title": "Not Found",
  "status": 404,
  "code": "not_found",
  "detail": "No product with handle \"blue-suitt\"",
  "hint": "Use /v1/search?q=... or /v1/products to find valid product handles.",
  "instance": "/v1/products/blue-suitt",
  "docs": "https://api.cecilbmenswear.com/docs"
}
StatuscodeMeaning
400bad_requestA parameter is missing or out of range
404not_foundUnknown path, product, collection or policy
405method_not_allowedOnly GET, HEAD and OPTIONS (and POST on /mcp) are accepted
429rate_limitedToo many requests; wait for Retry-After seconds
500internal_errorUnexpected server error; retry, then email support
502upstream_errorThe storefront did not answer; retry shortly
503upstream_errorThe storefront is busy; retry after Retry-After

Rate limits

120 requests per 60 seconds per client IP. Every response carries the IETF header RateLimit-Policy: "per-ip";q=120;w=60. Over the limit you get HTTP 429 with Retry-After and RateLimit: "per-ip";r=0;t=60. Responses are cached for about two minutes, so polling faster than that returns the same data.

Versioning and deprecation

The major version is in the path (/v1). Additive changes (new fields or endpoints) can ship at any time, so ignore fields you do not know. Breaking changes ship under a new path (/v2). A deprecated version keeps working for at least 6 months after notice; deprecation is announced in the changelog below and with Deprecation and Sunset response headers.

MCP server

The Cecil B Menswear MCP Server at https://api.cecilbmenswear.com/mcp is a Model Context Protocol server using the Streamable HTTP transport (JSON-RPC 2.0 over POST, no auth). Add it to any MCP client:

{ "mcpServers": { "cecilb-menswear": { "url": "https://api.cecilbmenswear.com/mcp" } } }

Tools (all read-only): search_products, get_product, list_products, list_collections, get_collection_products, get_store_info, get_policy.

Resources: cecilb://store, cecilb://collections, cecilb://catalog, and cecilb://policies/{refund|shipping|privacy|terms|contact}.

CLI

The official Cecil B Menswear CLI, cecilb, wraps this API for terminals, scripts and coding agents (Node.js 18+, no dependencies):

npm install -g https://api.cecilbmenswear.com/cli/cecilb-cli.tgz
cecilb search navy suit
cecilb product vitali-blue-seersucker-two-piece-suit --json

Store facts

Support

Email support@cecilbmenswear.com or call (313) 336-7294 during store hours.

Changelog