What it is
10ML Perfume Finder is a free, hosted Model Context Protocol (MCP) server that gives AI assistants structured perfume knowledge. You add a single URL — https://mcp.10ml.com/mcp — to your MCP client and the assistant can query the 10ML Fragrance Index (6,000+ perfumes) on its own while answering.
No API key, no account, no sign-up. Every tool is read-only.
Key features
- 15 read-only tools the assistant picks automatically from a plain-language question
- 6,000+ perfumes with houses, release years, families, accords and full note pyramids
- Similarity and alternatives — closest matches from the same or other houses, with shared notes and a closeness score
- Recommendations from your taste profile (notes you love or avoid, season, occasion)
- Explanations of notes, houses, concentration terms (EDT/EDP), sillage and accords
- 10 languages — English, German, French, Spanish, Italian, Romanian, Greek, Hungarian, Czech, Polish; localized note names are understood too
- Fast and accurate — in 10ML's own 40-question benchmark (20 Oct 2026) it scored 39/40 with ~232 ms median latency and one tool call per question
The tools
| Tool | Use case |
|---|---|
search_perfumes | Find scents by name, house, notes, accords, family, season or occasion |
get_perfume | Full profile of one perfume (pyramid, accords, seasons) |
compare_perfumes | Two to four perfumes side by side |
find_similar_perfumes | "What smells like X?" |
find_perfume_alternatives | Alternatives to a famous scent from other houses |
recommend_perfumes | Personal picks from a taste profile |
perfumes_by_note | Perfumes built around one note, most prominent first |
explain_note | What a note smells like, its family and pairings |
get_house / list_houses | House profiles and browsing by country or type |
explain_perfume_term | EDT vs EDP, sillage, accords, families |
suggest_layering | What layers well and how to spray it |
pick_for_occasion | Season, occasion, audience and style picks |
find_gift | Gift ideas by recipient and preferences |
search_guides | 10ML guides to read or cite, in ten languages |
Setup
- Claude (web / Desktop): Customize → Connectors → add 10ML Perfume Finder from the directory, or add a custom connector with the URL.
- Claude Code:
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp - ChatGPT: Plugins → Add custom MCP server, no authentication.
- Cursor / VS Code: one-click install links, or the URL in
~/.cursor/mcp.json/.vscode/mcp.json. - Gemini CLI:
gemini mcp add --transport http perfume-finder https://mcp.10ml.com/mcp - Windsurf, Cline, Goose, Zed: same URL, or the stdio packages
npx -y @10ml/perfume-finder-mcp/uvx perfume-finder-mcp.
Who it is for
Fragrance shoppers deciding between scents, gift buyers, perfume reviewers and content creators, and developers building fragrance-aware assistants or apps. If your own code needs the data directly, 10ML also offers a REST perfume API over the same index.
Fair use
Free with no key or quota to manage. Polite fair-use rate limiting may apply, pagination uses limit and cursor, and REST responses carry a five-minute cache header. No cookies, no tracking, no request history.
