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

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:

Related MCP server: agent-rails

⚡ 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:

{
  "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:

{
  "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:

{
  "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:

{
  "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)

npx -y @smithery/cli install bydoktor8181/thefashiondeals --client claude

2. Claude Desktop (claude_desktop_config.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

🛡️ 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

• Weekly Reports Hub: https://thefashiondeals.com/reports

• LLM Markdown Feed: https://thefashiondeals.com/reports/weekly-deal-index-2026-w38.md

• Open Datasets: JSON | CSV

• Developer API Documentation: https://thefashiondeals.com/developers

• Verification 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.