# Cecil B Menswear Developers

Build with live store data from Cecil B Menswear, a men's clothing store on the Upper Level of Fairlane Town Center in Dearborn, Michigan (suits, formalwear and statement fashion). Everything here is public and read-only, and nothing needs an API key: the REST API, the MCP server for AI agents, and the `cecilb` command-line tool.

## Overview

| Tool | What it is | Link |
|---|---|---|
| Cecil B Menswear API | REST/JSON: products, prices, availability, collections, search, store hours, policies | [API documentation](https://api.cecilbmenswear.com/docs) |
| OpenAPI 3.1 spec | Machine-readable description of every endpoint | [openapi.json](https://api.cecilbmenswear.com/openapi.json) |
| Cecil B Menswear MCP Server | Model Context Protocol server (Streamable HTTP) with 7 read-only tools and 8 resources | [MCP server](https://api.cecilbmenswear.com/mcp) |
| Cecil B Menswear CLI | `cecilb`, the official command-line tool (Node.js 18+) | [CLI](https://api.cecilbmenswear.com/cli) |
| API catalog | RFC 9727 linkset that points to all of the above | [api-catalog](https://api.cecilbmenswear.com/.well-known/api-catalog) |

## Quickstart

```bash
# 1. Search the catalog
curl "https://api.cecilbmenswear.com/v1/search?q=navy%20suit"

# 2. Read one product with every variant, price and availability
curl https://api.cecilbmenswear.com/v1/products/vitali-blue-seersucker-two-piece-suit

# 3. Store address, phone and opening hours
curl https://api.cecilbmenswear.com/v1/store

# 4. Exchange policy (full text)
curl https://api.cecilbmenswear.com/v1/policies/refund
```

From JavaScript (CORS is open, so this works in a browser too):

```javascript
const res = await fetch("https://api.cecilbmenswear.com/v1/search?q=dress%20shoes");
const { results } = await res.json();
```

With the CLI:

```bash
npm install -g https://api.cecilbmenswear.com/cli/cecilb-cli.tgz
cecilb search navy suit
cecilb store
```

With an MCP client:

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

## Authentication and API keys {#authentication}

You don't need an API key. Every endpoint is public and read-only, so there is no sign-up, no OAuth and no scopes, and there is nothing to create, revoke or rotate. Send requests directly.

- Access: anonymous, read-only (GET on the REST API, POST JSON-RPC on the MCP server)
- Rate limit: 120 requests per 60 seconds per client IP, advertised with the `RateLimit-Policy` header. Over the limit you get HTTP 429 with `Retry-After`.
- Errors: RFC 9457 `application/problem+json` with `code`, `detail` and `hint`

## Sandbox {#sandbox}

The live API is read-only, so it is safe to call from tests and notebooks: no request can change an order, a cart or the catalog. There is no separate sandbox host, because the production API is the sandbox. Use the try-it console on this page, or any HTTP client.

## Endpoints

| Method | Path | Description |
|---|---|---|
| GET | `/v1/search?q=` | Product search (up to 10 results) |
| GET | `/v1/products?page=&limit=` | All products, paginated |
| GET | `/v1/products/{handle}` | One product with variants, prices, availability |
| GET | `/v1/collections?page=&limit=` | Collections with product counts |
| GET | `/v1/collections/{handle}/products` | Products in one collection |
| GET | `/v1/store?fields=` | Address, phone, email, opening hours |
| GET | `/v1/policies?include_body=` | Policy index |
| GET | `/v1/policies/{policy_type}` | refund (exchange), shipping, privacy, terms, contact |

Base URL: `https://api.cecilbmenswear.com`. Full reference: [Cecil B Menswear API documentation](https://api.cecilbmenswear.com/docs).

## Prices

Prices are decimal strings in USD. A product without an online price returns `"price": null` and `"price_status": "pending - call the store"`. Don't show it as free; tell the shopper to call (313) 336-7294.

## Resources for agents

- [API llms.txt](https://api.cecilbmenswear.com/llms.txt) and [store llms.txt](https://cecilbmenswear.com/llms.txt)
- [This page as Markdown](https://cecilbmenswear.com/developers.md) and [developer llms.txt](https://cecilbmenswear.com/developers/llms.txt)
- [MCP server card](https://api.cecilbmenswear.com/.well-known/mcp/server-card.json)

## Support

Email support@cecilbmenswear.com or call (313) 336-7294 during store hours (Mon–Thu 11 AM–7 PM; Fri–Sat 11 AM–8 PM; Sun 12 PM–6 PM (mall holiday hours may differ)).
