# 10ML Fragrance Index [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/10ml-com/perfume-finder-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1085  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/10ml-fragrance-index

## Description
Expert perfume knowledge by 10ML's editors: notes, accords, families, similar scents and houses.

## Tools
Capabilities this server exposes over MCP:

- **search_perfumes** — Search the 10ML Fragrance Index for perfumes, colognes and fragrances (eau de parfum, eau de toilette, extrait) by name, house, notes, accords, family, audience, season, occasion or style. Natural language works: 'fresh citrus summer cologne for men' or 'warm vanilla scent for winter' is understood. Set iconic to true for only the editors' iconic, era-defining classics ('must-know perfumes for her', 'iconic winter scents'). Use when someone describes the scent they want, or names a perfume or house and you need matching fragrances. Not for the full profile of one known perfume (use get_perfume), not for 'something like X' (use find_similar_perfumes) and not for dupes or alternatives to a famous perfume (use find_perfume_alternatives). Returns ranked perfumes with house, year, family, accords, key notes, an editorial character line and 10ml.com links.
- **get_perfume** — The full Fragrance Index profile of one perfume, cologne or fragrance: house, launch year, audience, concentration, family, accords, note pyramid (top, heart and base notes), best seasons and occasions, longevity, projection and perfumers (full profiles), the editors' character description, five similar perfumes, editorial alternatives from other houses when they exist, related 10ML guides and links. Use when you know which perfume is meant and need facts about it ('tell me about Aventus', 'what notes are in Delina', 'what does Baccarat Rouge 540 smell like'). Not for browsing (use search_perfumes), not for comparing two or more (use compare_perfumes). Unknown names return the closest matches.
- **compare_perfumes** — Compare 2 to 4 perfumes or colognes side by side: notes they share, notes only one has, accords, family, audience, launch year, longevity and projection, plus plain-language differences ('A is fresher, B is sweeter and lasts longer') and how close they are overall. Use when someone is choosing between named fragrances or asks how two differ ('Sauvage vs Bleu', 'Delina or Layton', 'Aventus or Layton for summer'). Not for finding perfumes like one (use find_similar_perfumes) and not for one perfume's details (use get_perfume).
- **find_similar_perfumes** — Find perfumes and colognes that smell like one the person already likes, ranked by shared notes, accords and style, each saying exactly what it shares and how close it is (very close, similar vibe, same spirit). Works from a perfume in the index (name and house, or id) OR from free notes/accords for any other fragrance. Steer the result: fresher, sweeter, darker, lighter, longer_lasting or more_projection. Use for 'something like Baccarat Rouge 540', 'smells like Sauvage but fresher' or 'a scent with saffron and cedar'. Not for editorial dupes of a famous perfume from other houses (use find_perfume_alternatives) and not for free-text discovery (use search_perfumes).
- **find_perfume_alternatives** — The editors' alternatives (dupes) to a famous perfume or cologne, from other houses: for each, why it is close and how close (very close, similar vibe, same spirit), plus the 10ML guide that compares them. Covers about 100 iconic originals such as Creed Aventus, Baccarat Rouge 540, Delina, Sauvage, Black Opium or Santal 33. For other fragrances in the index the closest options from different houses are computed from notes and accords. Use for 'dupe of X', 'alternative to X', 'what smells like X from another house'. Not for general similarity inside the index (use find_similar_perfumes) and not for free-text discovery (use search_perfumes).
- **recommend_perfumes** — Personal perfume and cologne recommendations from taste: fragrances they love or dislike, notes they like or avoid, plus gender, season, occasion, style and family. Every pick says why (shared notes with a loved perfume, a liked note, fits the season). Use when someone says what they enjoy or avoid and wants suggestions ('I love Delina and vanilla, nothing too sweet, for winter evenings', 'my signature scent is Sauvage, what next'). Not for one-off filters without taste (use search_perfumes), not for a single occasion list (use pick_for_occasion) and not for gifts (use find_gift).
- **perfumes_by_note** — List the perfumes and colognes in the 10ML Fragrance Index built around a note or ingredient (vanilla, oud, bergamot, tonka bean, jasmine, patchouli, leather, sandalwood...), most prominent first, optionally only where the note sits in the top, heart or base, or for an audience, season or occasion. Spelling variants and other languages work (agarwood finds oud, Vanille finds vanilla). Use for 'perfumes with oud', 'a vanilla scent for winter' or 'bergamot-forward colognes for men'. Not for explaining what a note smells like (use explain_note) and not for several notes at once (use search_perfumes with notes_include).
- **explain_note** — Explain a fragrance note or perfume ingredient: what it smells like, its family and mood, where it comes from, which notes it pairs with, similar notes, famous perfumes where it leads and a link to the 10ML note page or guide when one exists. Covers about 285 notes in many spellings and languages. Use for 'what does ambroxan smell like', 'what is oud', 'what goes with bergamot', 'is iso e super a note'. Not for listing every perfume with the note (use perfumes_by_note) and not for general terms like EDP or sillage (use explain_perfume_term).
- **get_house** — Profile of a perfume house or fragrance brand: country, founded year, style (designer, niche, Middle Eastern, indie), what it is known for, its signature perfumes in the index and a link to explore it at 10ML. Understands nicknames (YSL, MFK, PDM, Paco Rabanne). Use for 'tell me about Creed', 'what is Amouage known for' or 'best Dior perfumes'. Not for browsing all houses (use list_houses) and not for one perfume (use get_perfume).
- **list_houses** — Browse the perfume houses and fragrance brands in the 10ML Fragrance Index with country, type (designer, niche, middle-eastern, indie, celebrity), perfumes profiled and what each is known for. Filter by type, country or a name fragment. Use when someone wants to explore brands, find niche or Middle Eastern houses, or see which houses are covered. Not for one house's full profile (use get_house) and not for perfumes (use search_perfumes).
- **explain_perfume_term** — Explain perfume vocabulary and fragrance families: concentrations (eau de cologne, eau de toilette, eau de parfum, extrait, elixir), sillage, projection, longevity, dry down, accord, top/heart/base notes, flanker, maceration, layering, niche vs designer, plus the 23 fragrance families (chypre, fougere, gourmand, oriental / amber...) with their key notes and example perfumes. Use for 'what is the difference between EDT and EDP', 'what is a chypre', 'what does sillage mean'. Leave term empty to list everything covered. Not for individual notes (use explain_note).
- **suggest_layering** — Perfume and fragrance layering ideas: which notes or perfumes combine well, what the combination smells like, how to spray (order, amount) and when it suits. Works from two notes ('vanilla and citrus'), one note (what it layers with), one perfume (partners from the index) or two perfumes (does this pair work). Editorial pairings are marked 'editors'; others are marked 'suggested' and should be tested on skin. Use for 'how do I layer vanilla', 'can I layer Delina with something', 'does Sauvage layer with Aventus'. Not for choosing a single perfume (use recommend_perfumes).
- **pick_for_occasion** — Perfume and cologne picks for a moment: a season, an occasion (daytime, office, casual, evening, date night, special occasion), an audience and a style, each with the reason it fits. Use for 'a fresh summer office scent for men', 'date night perfume for her' or 'what fragrance to wear to a winter wedding'. Give at least one of season, occasion, gender or style. Not for taste-based matching (use recommend_perfumes), not for gifts (use find_gift) and not for classics (use search_perfumes with iconic true).
- **find_gift** — Perfume and fragrance gift ideas from who the gift is for: recipient (him, her or anyone), relationship, age range, perfumes or notes they already love, style, occasion and how adventurous to be. Each pick comes with the reason it suits them. Use for 'gift for a woman who loves Delina', 'something safe for my dad' or 'a bold present for a friend'. Not for personal taste recommendations (use recommend_perfumes) and not for classics lists (use search_perfumes with iconic true).
- **search_guides** — Find 10ML's perfume and fragrance guides to read or cite: how-tos (where to spray, finding a signature scent, making perfume last), notes explained, house guides, lists, and alternatives guides that compare famous perfumes with similar ones from other houses. Returns title, type and a link per locale. Use whenever you want a source to cite or a deeper read ('how to layer perfume', 'best oud perfumes', 'Creed Aventus dupes guide'). Not for facts about a perfume (use get_perfume) and not for note definitions (use explain_note).

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What 10ML Fragrance Index does

10ML Fragrance Index exposes 10ML's perfume and fragrance data through Model Context Protocol. Its tools cover perfume and cologne search, full fragrance profiles, comparisons, similar scents, alternatives from other houses, taste-based recommendations, note exploration, fragrance houses, terminology, layering, occasions, gifts and editorial guides.

The data includes details such as launch year, concentration, audience, fragrance family, accords, note pyramids, seasons, occasions, longevity, projection and perfumers where available. Results can also include editorial descriptions, similarity explanations, alternative recommendations and links to 10ml.com pages.

Use it for questions such as finding a fresher scent with a similar style, comparing two named fragrances, explaining ambroxan, choosing a gift, or locating a guide about making perfume last longer. Search also supports editor-selected iconic fragrances through the `iconic` option.

## How it works

The hosted MCP endpoint is available at `https://mcp.10ml.com/mcp`. It uses Streamable HTTP, requires no API key or sign-in, and is read-only. Clients that accept a remote MCP URL can connect directly without installing a local package.

For local stdio deployments, the server can be started with either the npm package through `npx` or the Python package through `uvx`. The same fragrance service is also available through a REST API, with OpenAPI and `llms.txt` descriptions for agents that do not use MCP.

Tools accept a `locale` value for localized labels and links in English, German, French, Spanish, Italian, Romanian, Greek, Hungarian, Czech or Polish. Most tools also accept `response_format`, using concise output by default or a detailed response when more fields are needed. List-oriented results support pagination with `limit` and `cursor`.

## Setup and configuration

For remote clients, add this URL as a custom MCP connector:

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

A local Node.js setup uses:

```bash
npx -y @10ml/perfume-finder-mcp
```

The Python alternative is:

```bash
uvx perfume-finder-mcp
```

The local runner requires Node.js 18 or newer, or Python 3.10 or newer, respectively. Claude Desktop, Cursor, Windsurf, Cline and Zed can use the stdio command configuration. Claude Code supports adding the remote endpoint with its MCP command, while VS Code can add the server as an HTTP connection.

## Tools and capabilities

- Search perfumes by name, house, notes, accords, family, audience, season, occasion, style or natural-language description.
- Retrieve complete profiles with note pyramids, performance details, similar perfumes, alternatives and related guides.
- Compare two to four fragrances and identify shared notes, distinct notes, performance differences and overall closeness.
- Find similar scents from an indexed perfume or from free-form notes and accords, with steering such as fresher, sweeter, darker or longer-lasting.
- Find editorial alternatives to well-known perfumes and explain why each option is close.
- Recommend fragrances from liked or disliked perfumes, preferred or avoided notes, season, occasion, style and family.
- Explore notes, perfume houses, fragrance terms, layering combinations, occasions, gifts and 10ML guides.

The server also provides MCP prompts for signature-scent selection, dupes, perfume explanations, fragrance wardrobes, gifts and seasonal rotations, plus resources for families, glossary terms, notes, houses and individual perfume records.

## Limitations and notes

This service is read-only: its tools retrieve and explain fragrance information rather than modifying records. Similarity, recommendation and alternative tools serve different purposes; general similarity is separate from editorial dupes, while taste-based recommendations differ from simple filtering or occasion lists. Unknown perfume names are resolved to closest matches by the profile lookup tool.

Every tool can return structured content with an output schema and a short text summary. Links and labels follow the selected locale. The service covers approximately 285 fragrance notes, 23 fragrance families and around 100 iconic originals for its editorial alternatives feature.

_Full upstream README: https://allmcps.com/mcp/10ml-fragrance-index/readme_