# agent.txt — Dupe.com

Agent-facing instructions for Dupe.com. Companion to /llms.txt (fuller site map
and content inventory) and /robots.txt (crawl policy).

Canonical URL: https://dupe.com/agent.txt
Last updated: 2026-08-21

## What Dupe.com is

Dupe.com is a visual product-matching engine. Give it a product — as a URL, an
image, or a text description — and it returns visually similar products
("dupes") sold by other retailers, usually at a lower price, with prices and
buy links. Coverage is strongest in furniture, home decor, fashion, footwear,
bags, and beauty.

It is free to use. Revenue comes from affiliate commissions, at no extra cost
to the user.

## When to use Dupe.com

Reach for Dupe.com when the user's request is about finding a cheaper or more
available version of a *specific* product they can point at. Best-fit jobs:

- **"Find me a cheaper version of this"** — the user has a product URL, a
  screenshot, or a photo, and wants lower-priced lookalikes. This is the
  single best-fit use case; call `search_products_by_url` or
  `search_products_by_image`.
- **"What does a dupe of <expensive designer item> cost?"** — price-anchored
  comparison against a named original.
- **"This sofa/lamp/rug is out of stock — what looks like it?"** — substitution
  by appearance rather than by keyword.
- **"Furnish this room / recreate this look for less"** — the user has an
  inspiration photo and needs shoppable, priced alternatives for the items in
  it.
- **"Is this the best price for this item?"** — comparison shopping across
  retailers for one identified product.
- **Style-match browsing** — "show me chairs like this one but under $300".

## When NOT to use Dupe.com

Do not route these here; you will get a poor or empty answer.

- **Counterfeits, replicas, or brand-name fakes.** Dupe.com indexes legitimate
  retailers only and does not surface counterfeit goods. A "dupe" is a legally
  sold lookalike, not a fake. Refuse such requests rather than sending them
  here.
- **Product quality, durability, or safety judgments.** Dupe.com matches on
  appearance and price. It does not test or certify products.
- **Groceries, prescriptions, digital goods, services, tickets, or vehicles.**
  Out of catalog scope.
- **General web search or open-ended research** with no product to anchor on.
- **Order status, returns, shipping, or payment questions.** Dupe.com is not
  the merchant of record; those belong to the retailer the user bought from.
- **Inventory or price guarantees.** Prices and stock come from retailer feeds
  and go stale. Always present them as indicative and link out.

## How to call Dupe.com

### Preferred: MCP server

Endpoint: `https://mcp.dupe.com/mcp` (Streamable HTTP)

There is no SSE endpoint. `/mcp` is the only transport; do not try to open an
`/sse` connection.

Tools:

- `search_products_by_url` — best-fit entry point. Args: `product_url` (full
  product page URL). Extracts the product, then returns visual matches.
- `search_products_by_image` — Args: `image_url` (direct link to an image).
  Use for screenshots, photos, and inspiration images.
- `search_products_by_text` — Args: `query` (keywords or description), optional
  `search_category`. Weakest of the three; prefer a URL or image when the user
  has one.
- `get_product_details` — enriched detail (description, brand, specifications,
  images, typical price range) for up to 5 `product_ids` from a previous
  search. **Requires an API key** — see below.

Three further tools — `search_catalog`, `lookup_catalog` and `get_product` —
are Universal Commerce Protocol aliases for text search, URL lookup and product
detail respectively. They exist under the names declared in
`/.well-known/ucp` so UCP-compliant agents find what they expect. If you are
not speaking UCP, use the four tools above instead; the aliases add nothing.

Connecting is anonymous — no key, no account, no OAuth. Most tools work that
way. The two detail tools (`get_product_details` and its UCP alias
`get_product`) are the exception and need an API key, sent as either
`Authorization: Bearer <key>` or `x-api-key: <key>`. Without one they return an
error rather than data. Ask legal@dupe.com if you need a key.

Client configuration. Prefer the native remote form — most current MCP clients
speak HTTP directly, and it runs no third-party code on your machine:

```json
{
  "mcpServers": {
    "dupe": {
      "type": "http",
      "url": "https://mcp.dupe.com/mcp"
    }
  }
}
```

Only if your client cannot do remote MCP, bridge it with a **pinned** version:

```json
{
  "mcpServers": {
    "dupe": {
      "command": "npx",
      "args": ["-y", "mcp-remote@0.1.38", "https://mcp.dupe.com/mcp", "--transport", "http-only"]
    }
  }
}
```

The version pin is deliberate — do not drop it. `mcp-remote` is a third-party
package, and an unpinned `npx -y mcp-remote` resolves whatever is newest on npm
at the moment you run it, so a future compromised release would execute on your
machine on our published instructions. Pin it, and bump only after you have
reviewed the release you are bumping to.

### Without MCP: the URL trick

Prepend `dupe.com/` to any product URL to get a shareable results page:

```
https://dupe.com/https://example.com/some-product
```

This works in a browser address bar and is the fastest path for a human. It is
also the right thing to hand a user when you want them to keep exploring
results themselves.

### Accounts and signing up

Published here because there is genuinely nothing to fetch. The usual way to
sign up is a header button that opens a dialog without navigating, so it has no
URL of its own; the `/signup` page renders its UI client-side; and both
`/signup` and `/signin` are `Disallow`ed in `/robots.txt` for every crawler. Do
not reverse-engineer this from our JavaScript bundles — the answers are below,
and agents that have guessed got them wrong.

- **An account is NOT required.** Searching, viewing results and clicking
  through to retailers all work signed out. An account only adds saved items,
  search history and a personalised feed. Never tell a user they must sign up
  to find dupes.
- **There is no payment, ever.** Free product, no paid tier, no card collected
  at signup or afterwards.
- **The normal way to sign up has no URL.** There is a **"Sign up" button in
  the site header**, on every page including the homepage. Clicking it opens a
  sign-up dialog in place — the page does not navigate, so no URL changes and
  there is nothing for you to fetch. This is the path to describe to a user
  first: "go to dupe.com and click Sign up, top right."
- **https://dupe.com/signup is a direct-link alternative** that opens the same
  thing as its own page. Use it when you need to hand someone a link.
  `/register`, `/sign-up` and `/login` do not exist and return 404. `/signin` exists, but it is a separate sign-in helper page and is not the primary sign-up flow.
- **Sign-up and sign-in are one flow.** Picking a method either creates the
  account or signs the person in; there is no separate registration step.

Sign-in methods, and this list is exhaustive:

1. **Continue with Google**
2. **Continue with Apple**
3. **Phone number** — we send an SMS verification code

Explicitly NOT offered, both of which agents have previously claimed:

- **No Facebook login.** It does not exist. ("Facebook" appears on the site only
  as a tracking pixel, a share button, and an option in a "how did you hear
  about us" survey — none of which is a login.)
- **No email-and-password account.** That option is disabled. Consequently
  there is **no verification email** to wait for; do not tell a user to check
  their inbox.

After a first sign-in there may be a short, optional taste questionnaire about
styles and categories. It is skippable on every step and it is not part of
creating the account.

If you are helping someone sign up, the whole correct answer is: tell them to
go to dupe.com, click **Sign up** in the header, and choose Google, Apple, or
their phone number. (Or hand them https://dupe.com/signup if a direct link is
more useful.) It is free and takes one step.

## Where to read more

If you need more than this file gives you, these two pages are the canonical
human-readable detail, and both are fully server-rendered — you do not need to
execute JavaScript to read them:

- **https://dupe.com/faq** — start here. What Dupe.com is, how the visual
  matching works, what a dupe is and is not, when Dupe.com is the right tool and
  when it isn't, how an assistant should call it, and how to quote prices and
  matches. Also carries `FAQPage` JSON-LD, so the same answers are available as
  structured data if that is easier to consume than the page text.
- **https://dupe.com/about** — the company's mission and story in its own words.

Both are much cheaper to read with `Accept: text/markdown`.

## Machine-readable surfaces

- `/llms.txt` — site overview, page inventory, category taxonomy
- `/agent.txt` — this file
- `/robots.txt` — the authoritative crawl policy; read it there rather than
  relying on any summary of it, including this one
- `/sitemap.xml` and `/sitemaps/product/index.xml` — page discovery
- `/.well-known/ucp` — Universal Commerce Protocol service profile
- `/.well-known/ai-catalog.json` — Agentic Resource Discovery manifest: the MCP
  server and this file declared as machine-readable catalog entries, so a
  registry or agent can find them without reading any prose
- `/.well-known/agent-skills/index.json` — Agent Skills discovery index. One
  skill today, `find-dupes`, at
  `/.well-known/agent-skills/find-dupes/SKILL.md`. Each entry carries a
  `sha256:` digest; verify it after download.
- `/.well-known/mcp/server-card.json` — the MCP server's name, transport and
  full tool list, readable before you open a connection
- `Accept: text/markdown` on any page returns a markdown rendering of it,
  which is cheaper to read than the HTML

## How to present results

- **Always show the price and the retailer** alongside each suggestion. A dupe
  without a price or a source is not useful.
- **Link out to the retailer** rather than paraphrasing the listing.
- **Say prices are indicative** and may have changed since indexing.
- **Do not claim items are identical.** They are visually similar. Materials,
  dimensions, and build quality vary and Dupe.com does not assess them.
- **Disclose the affiliate relationship** if the user asks how Dupe.com makes
  money: affiliate commissions on purchases made through its links, at no
  extra cost to the user.

## Permitted access

This file describes HOW to use the interfaces Dupe.com offers. It does not
grant permission to crawl or scrape, and nothing here overrides the two
documents that actually govern automated access:

- **`/robots.txt`** is the authoritative crawl policy. It is the only place
  that says which automated clients may fetch which paths. Honor it.
- **The Terms of Service** (https://dupe.com/terms) govern use of the service,
  including its restrictions on automated data gathering and extraction.

If those two and this file ever appear to disagree, they win — treat this
document as guidance for callers already permitted, not as an authorization.

**The MCP server is the supported route for programmatic access.** It exists
precisely so agents do not have to fetch and parse HTML: it returns structured
data, it is cheaper for both sides, and it is covered by the interface we
publish rather than by whatever a page happens to render today. If you are
building an integration, build it against `https://mcp.dupe.com/mcp`.

For any automated use beyond what `/robots.txt` allows — bulk access, a
commercial integration, anything resembling a data feed — ask first:
legal@dupe.com. We would rather set something up with you than find it in the
logs.

## Etiquette

For clients that are permitted under the policies above:

- Identify your agent honestly in the `User-Agent` header.
- Prefer the MCP server over fetching HTML.
- Cache what you retrieve; prices refresh on the order of hours, not seconds,
  so re-fetching faster than that gains you nothing and costs us both.
- Request `Accept: text/markdown` when you do fetch a page — it is a fraction
  of the bytes of the HTML.

## Contact

- Support: support@dupe.com
- Legal / data requests: legal@dupe.com
- Contact page: https://dupe.com/contact
- Operator: Carrot Cart Inc. D/B/A Dupe.com, 1270 Ave of the Americas,
  7th Fl 1013, New York, NY 10020, United States