# 10ML Perfume Finder

> 10ML Perfume Finder is a free MCP server for e-commerce. Free perfume search, notes and similar-scent lookup for AI assistants. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI
- **Website:** https://mcp.10ml.com
- **Repository:** https://github.com/10ml-com/perfume-finder-mcp
- **MCP Registry name:** com.10ml/perfume-finder
- **Categories:** e-commerce
- **Listing updated:** 2026-11-14

## About

Behind the server is the 10ML Fragrance Index, which the site puts at 6,018 perfumes and 249 houses, each with a note pyramid, accords and family. A smaller set of 481 editorial profiles adds longevity, projection and perfumers. The operator, 10ML, is an online shop for perfume samples and decants, and answers link to its own guide and note pages in seventeen languages.

The server exposes 15 read-only tools, 6 prompts, resources and completions. Typical questions are what smells like a favourite, how to layer two scents, what a note like ambroxan is, or how two perfumes compare. Editors' alternatives (dupes) come with the reason each is close.

It connects as a remote Streamable HTTP endpoint with no key or sign-in, or runs locally over stdio through npm or PyPI. The vendor reports its own 40-question benchmark, which should be read as a vendor claim.

## Features

- **Perfume search:** Find perfumes by name, notes, accords, family, audience, season or occasion.
- **Side-by-side comparison:** Compare two to four perfumes on shared notes and differences.
- **Similar scents:** Find perfumes close to one you love, steered fresher, sweeter or darker.
- **Editor alternatives:** Editors' alternatives to famous perfumes from other houses.
- **Note explainers:** What a note smells like, what it pairs with and which perfumes lead with it.
- **No key needed:** One URL, read-only, no sign-in.

## Good for

- Ask for a perfume similar to a favourite
- Compare two fragrances before buying
- Find a gift perfume from the recipient's favourite
- Learn what a perfume note smells like
- Get layering ideas for two scents

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.10ml.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "perfume-finder": {
      "url": "https://mcp.10ml.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "perfume-finder": {
      "type": "http",
      "url": "https://mcp.10ml.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "perfume-finder": {
      "serverUrl": "https://mcp.10ml.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "perfume-finder": {
      "type": "http",
      "url": "https://mcp.10ml.com/mcp"
    }
  }
}
```

## Tools

- `search_perfumes`: Find perfumes by name, notes, accords, family, audience, season, occasion or style.
- `get_perfume`: Full profile of one perfume with similar perfumes, alternatives and guides.
- `compare_perfumes`: Two to four perfumes side by side.
- `find_similar_perfumes`: Perfumes that smell like one you love or like a list of notes.
- `find_perfume_alternatives`: Editors' alternatives to famous perfumes from other houses.
- `recommend_perfumes`: Picks from what you love, dislike and avoid, with reasons.
- `perfumes_by_note`: Every perfume built around a note.
- `explain_note`: What a note smells like and what it pairs with.
- `get_house`: A perfume house: country and style.

## FAQ

### Do I need an API key?

No. The remote endpoint needs no key or sign-in.

### Can it change anything?

No. All 15 tools are read-only.

### How can I run it locally?

Use npx -y @10ml/perfume-finder-mcp or uvx perfume-finder-mcp.

### Which clients work?

Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline and other MCP clients.

### Is 10ML Perfume Finder free?

Yes. 10ML Perfume Finder is free to use.

### How do I add 10ML Perfume Finder to Claude Code?

Run this command in your terminal: claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp

### What are the best alternatives to 10ML Perfume Finder?

The closest alternatives to 10ML Perfume Finder are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/10ml-perfume-finder
