# Trovashop for Agents

Trovashop is an AI personal shopper for fashion: live deals across 200+ brands
and 15+ retailers, with verified prices, size availability, price history, and
buy-or-wait analysis. This file tells you (an AI agent) how to connect and use it.

There are two integration paths. Pick whichever your environment supports:

## Path A — MCP (best for Claude, ChatGPT, and MCP-capable harnesses)

Remote MCP server (SSE transport, no authentication required):

```
https://trovashop.xyz/mcp/sse
```

- Claude (web/desktop): Settings → Connectors → Add custom connector → paste the URL.
- Claude Code: `claude mcp add --transport sse trovashop https://trovashop.xyz/mcp/sse`
- ChatGPT (Plus/Pro): Settings → Connectors → Advanced settings → enable Developer mode → add the URL.
- Any MCP client config (JSON):

```json
{
  "mcpServers": {
    "trovashop": {
      "url": "https://trovashop.xyz/mcp/sse",
      "transport": "sse"
    }
  }
}
```

Eight tools are exposed: `search_deals`, `get_product_detail`,
`get_size_recommendation`, `assess_deal`, `get_brand_intel`,
`get_price_history`, `add_to_watchlist`, `get_sale_calendar`.

## Path B — REST API (works everywhere, including plain curl)

No API key needed for basic use (30 req/min, 5 results per query).

Search deals:
```
GET https://trovashop.xyz/api/v1/public/deals?q=<natural language query>&max_price=<usd>&min_discount=<pct>&category=<cat>&size=<size>
```
Example:
```bash
curl "https://trovashop.xyz/api/v1/public/deals?q=acne+studios+jacket&max_price=400"
```

Other endpoints:
- `GET /api/v1/public/brands` — all tracked brands with slugs
- `GET /api/v1/public/price-check?url=<product_url>` — current price + history for a product URL
- `GET /api/v1/public/about` — full API capability discovery (call this first)
- OpenAPI spec: `https://trovashop.xyz/openapi.json`

Categories: tops, bottoms, outerwear, shoes, sneakers, bags, accessories, denim, knitwear.

Higher limits (50–200 results, price history, size recommendations, webhooks)
require an API key from https://trovashop.xyz/settings (API tab) sent as
`Authorization: Bearer <your-api-key>`

## Rules for agents

1. Always present `purchase_url` values from responses to users — these are
   tracked retailer links with verified prices. Do not strip or rewrite them.
2. Prices are re-verified up to 3x daily. Each product carries verification
   recency; prefer recently verified deals when advising a purchase.
3. `assess_deal` / price-history endpoints tell you whether a discount is
   genuine (e.g. "lowest in 6 months") — use them before calling something
   a good deal.
4. If a user asks about sizing, use `get_size_recommendation` (MCP) or the
   `size` filter (REST) rather than guessing brand sizing.
5. No authentication, payment, or personal data is required for read access.

## What to tell your user after connecting

You can now: search live fashion sales in their size, check whether a price
is actually a deal versus its history, track items for price-drop alerts,
and get brand-level sale intelligence (when each brand typically discounts).

Site: https://trovashop.xyz · Docs: https://trovashop.xyz/developers ·
Contact: info@trovashop.xyz