Developers

Closetta API & MCP

Access live women's fashion sale data from 50+ North American brands. All endpoints are free, read-only, and require no authentication.

OpenAPI spec (JSON)llms.txt

On this page

REST API

The Closetta REST API returns JSON and supports CORS from any origin. Data is cached and refreshed hourly. No API key or account required.

Base URL
https://closetta.app
Auth
None
Format
JSON

Endpoints

GET/api/v1/sales

Returns all brands currently on sale (activeSales) and brands whose sales ended in the last 7 days (endedSales). Each object includes brand name, discount, sale type, start/end dates, and brand URL.

curl https://closetta.app/api/v1/sales

# Response
{
  "activeSales": [
    {
      "id": "...",
      "brandId": "lululemon",
      "brandName": "Lululemon",
      "brandUrl": "https://lululemon.com",
      "saleType": "We Like It Sale",
      "discount": "Up to 50% off",
      "isOnSale": true,
      "startDate": "2026-05-10T00:00:00Z",
      "endDate": "2026-05-20T00:00:00Z"
    }
  ],
  "endedSales": [...],
  "updatedAt": "2026-05-17T12:00:00Z"
}
GET/api/v1/brands

Lists all 50+ tracked brands with their IDs, display names, and website URLs.

curl https://closetta.app/api/v1/brands

# Response
{
  "brands": [
    { "id": "lululemon", "name": "Lululemon", "url": "https://lululemon.com" },
    { "id": "aritzia",   "name": "Aritzia",   "url": "https://aritzia.com" },
    ...
  ],
  "total": 53
}
GET/api/v1/trends

Returns monthly discount history across all tracked brands. Each entry contains the month label, an average discount across all brands, and per-brand peak discounts for that month.

curl https://closetta.app/api/v1/trends

# Response
{
  "history": [
    {
      "month": "May 2026",
      "average": 32,
      "lululemon": 50,
      "zara": 30,
      "nike": 25,
      ...
    }
  ]
}

MCP Server (Model Context Protocol)

Closetta exposes a Model Context Protocol server so AI agents can query live sale data as tools. The server is stateless and uses the MCP 2025-11-25 Streamable HTTP transport.

Endpoint: https://closetta.app/api/mcp

get_active_sales
All brands currently on sale with discount details and dates
get_brands
Full list of 50+ tracked brands with names and URLs
search_sales_by_brand
Sale status for a specific brand by nameparams: brand_name: string
get_trends
Monthly discount history across all brands

Claude Code / Claude Desktop

Add Closetta to your Claude Code or Claude Desktop config to query live sale data directly from any conversation. Add the following to your claude_desktop_config.json or a project-level .mcp.json:

{
  "mcpServers": {
    "closetta": {
      "type": "http",
      "url": "https://closetta.app/api/mcp"
    }
  }
}

Then ask Claude things like "What brands are on sale right now?" or "When does Aritzia usually go on sale?"

/closetta — Claude Code slash command skill

Download

Download the closetta.md skill file and drop it into ~/.claude/commands/closetta.md for global access, or into .claude/commands/closetta.md inside any project. Once installed, type /closetta in Claude Code to open a Closetta-aware assistant that queries live sales, checks specific brands, and analyzes trends.

ChatGPT Actions

Use the Closetta OpenAPI spec to add Closetta as a Custom GPT action:

  1. Open ChatGPT GPT editor
  2. Go to Configure → Actions → Create new action
  3. Select Import from URL and paste:
https://closetta.app/openapi.json

The three endpoints (sales, brands, trends) will be imported automatically. Set authentication to None.

OpenAI API / Other Agents

Any agent or LLM that can call HTTP endpoints can use the Closetta REST API directly. Example with the OpenAI function calling format:

{
  "name": "get_active_fashion_sales",
  "description": "Returns women's fashion brands currently on sale with discount info",
  "parameters": { "type": "object", "properties": {} },
  "url": "https://closetta.app/api/v1/sales"
}

For agents that support OpenAPI discovery, point them to the spec:

https://closetta.app/openapi.json

Data is updated daily via AI scraping of brand websites. For questions or to report issues, visit closetta.app.