# TheFashionDeals — Real-Time Amazon US Fashion Deal Intelligence MCP Server

[![MCP Server](https://img.shields.io/badge/MCP-Standard%20JSON--RPC%202.0-blue)](https://thefashiondeals.com/api/social/mcp)
[![Smithery Quality](https://img.shields.io/badge/Smithery-Verified%2094%2F100-brightgreen)](https://smithery.ai/servers/bydoktor8181/thefashiondeals)
[![Verified on Glama](https://img.shields.io/badge/Glama-Official%20Remote-purple)](https://glama.ai/mcp/servers/TheFashionDeals/thefashiondeals-mcp-server)
[![Monitored Catalog](https://img.shields.io/badge/Monitored%20ASINs-60%2C000%2B-orange)](https://thefashiondeals.com/reports)
[![Price Index](https://img.shields.io/badge/WFPI-Weekly%20Price%20Index-emerald)](https://github.com/TheFashionDeals/amazon-fashion-deal-index)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

> Search, filter, and stream live, verified Amazon US fashion deals and price drops by keyword, brand, category, price ceiling, and discount percentage. Built specifically for AI shopping agents, Claude Desktop, Cursor, and autonomous LLM developers via the **Model Context Protocol (MCP)**.

---

## 📖 TheFashionDeals Data Dictionary & Monitored Universe

To ensure academic and machine transparency, all deal metrics adhere to a strict semantic definition:

| Metric | Weekly Baseline Value | Semantic Definition |
| :--- | :--- | :--- |
| **Monitored Universe** | **63,594 ASINs** | Total Amazon US fashion catalog actively monitored at weekly snapshot time across clothing, shoes, bags & watches. |
| **Active Verified Deals** | **13,363 Deals** | Products in stock satisfying $\ge 15\%$ verified discount against 90-day historic median baseline. |
| **Market Average Discount** | **30.5% OFF** | Mean algorithmic discount across all live verified deal categories. |
| **Deep Liquidation Clearance** | **102 Deals** | Extreme price drops ($\ge 70\%$ discount) representing seasonal liquidation or algorithmic glitch drops. |
| **Consumer Savings Pool** | **$255,705.63** | Aggregate net dollar savings across all active verified deals at snapshot time. |

---

## ⚡ The 3 Canonical Killer Demos (Executable Proof)

### 🛒 Demo 1 — Shopping Agent (Transactional Discovery)
**User Prompt:**  
> *"Find 5 women's designer shoes on Amazon US under $50 with at least 60% verified discount."*

**Agent MCP Tool Call:**
```json
{
  "name": "search_fashion_deals",
  "arguments": {
    "search": "designer shoes",
    "category": "womens-shoes",
    "max_price": 50.00,
    "min_discount": 60,
    "limit": 5
  }
}
```

**Validated Snapshot with Provenance Returned to Agent:**
```json
{
  "total_found": 5,
  "deals": [
    {
      "asin": "B0D776LJJN",
      "title": "Reebok Club C 85 Mens Tennis Shoes, Chalk/Navy/Flint Grey",
      "brand": "Reebok",
      "current_price": 23.18,
      "original_price": 85.00,
      "currency": "USD",
      "discount_percentage": 73,
      "prime": true,
      "availability": "in_stock",
      "verification_method": "90_day_historic_median_audit",
      "source": "TheFashionDeals Real-Time Deal Intelligence",
      "canonical_url": "https://thefashiondeals.com/deal/reebok-club-c-85-b0d776ljjn",
      "deal_url": "https://thefashiondeals.com/deal/reebok-club-c-85-b0d776ljjn?utm_source=claude_mcp",
      "last_checked_at": "2026-09-17T16:06:41-07:00"
    }
  ]
}
```

---

### 🏷️ Demo 2 — Brand Intelligence (Opportunity Discovery)
**User Prompt:**  
> *"Audit current verified discount opportunities for Nike, Coach, and Levi's on Amazon US."*

**Agent MCP Tool Call:**
```json
{
  "name": "get_brand_discounts",
  "arguments": {
    "brand": "Nike"
  }
}
```

**Returned Intelligence:**
Returns brand discount median, in-stock count, top clearance items, and verified deal URLs.

---

### 📊 Demo 3 — Market Intelligence & Weekly Index (Macro Context)
**User Prompt:**  
> *"What are the steepest Amazon US fashion clearance drops right now, and how does this week's discount environment compare?"*

**Agent MCP Tool Call:**
```json
{
  "name": "get_top_deals",
  "arguments": {
    "limit": 10
  }
}
```
**Connected Resource:**  
The agent also queries `https://thefashiondeals.com/reports/weekly-deal-index-latest.md` (WFPI resource) to retrieve macro-level category averages and historical trend benchmarks.

---

## 🚀 Quick Setup & Installation

### 1. Smithery (One-Click Install)
```bash
npx -y @smithery/cli install bydoktor8181/thefashiondeals --client claude
```

### 2. Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "thefashiondeals": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://thefashiondeals.com/api/social/mcp"
      ]
    }
  }
}
```

### 3. Cursor IDE
- **Name:** `TheFashionDeals`
- **Type:** `sse`
- **Server URL:** `https://thefashiondeals.com/api/social/mcp`

---

## 🛠️ MCP Tools Reference

| Tool Name | Type | Description | Key Parameters |
| :--- | :--- | :--- | :--- |
| **`search_fashion_deals`** | Transactional | Search real-time Amazon fashion discounts by keyword, category, price, and discount percentage. | `search`, `category`, `max_price`, `min_discount`, `limit` |
| **`get_top_deals`** | Opportunity | Retrieve top steepest clearance price drops (50% to 90% off) across entire catalog. | `limit` (default: 10, max: 20) |
| **`get_brand_discounts`** | Intelligence | Get real-time discount intelligence and active verified deals for a specific fashion brand. | `brand` (required) |

---

## 🛡️ Provenance Contract & Data Integrity

Every deal returned by TheFashionDeals MCP server carries complete cryptographic and temporal provenance:
* **`verification_method`**: Price drop validated against 90-day historic median price baseline to eliminate fake retail price inflation.
* **`last_checked_at`**: Precise ISO-8601 timestamp of live stock and price verification.
* **`prime`**: Verified Prime fast shipping & free returns status.
* **`canonical_url`**: Direct canonical URL on TheFashionDeals.com.

---

## 🔗 Connected Open Datasets & Research
* **Weekly Price Index Repositories:** [github.com/TheFashionDeals/amazon-fashion-deal-index](https://github.com/TheFashionDeals/amazon-fashion-deal-index)
* **Weekly Reports Hub:** [https://thefashiondeals.com/reports](https://thefashiondeals.com/reports)
* **LLM Markdown Feed:** [https://thefashiondeals.com/reports/weekly-deal-index-2026-w38.md](https://thefashiondeals.com/reports/weekly-deal-index-2026-w38.md)
* **Open Datasets:** [JSON](https://thefashiondeals.com/data/weekly/2026-W38-deals.json) | [CSV](https://thefashiondeals.com/data/weekly/2026-W38-deals.csv)
* **Developer API Documentation:** [https://thefashiondeals.com/developers](https://thefashiondeals.com/developers)
* **Verification Methodology:** [https://thefashiondeals.com/methodology](https://thefashiondeals.com/methodology)

---

## ⚖️ Amazon Associates Compliance
TheFashionDeals is a participant in the Amazon Services LLC Associates Program. As an Amazon Associate, TheFashionDeals earns from qualifying purchases. Product prices and availability are accurate as of the snapshot date/time indicated and are subject to change. Any price and availability information displayed on Amazon.com at the time of purchase will apply to the purchase of this product.