10ML Perfume Finder

Free perfume MCP server that gives Claude and ChatGPT fragrance knowledge

Beginner API
Screenshot of 10ML Perfume Finder, Free perfume MCP server that gives Claude and ChatGPT fragrance knowledge

What is 10ML Perfume Finder?

10ML Perfume Finder is a product comparison tool. A free, keyless MCP server that plugs fragrance data into Claude, ChatGPT, Cursor, VS Code and other assistants. It exposes 15 read-only tools for searching 6,000+ perfumes, comparing scents, finding similar bottles and building recommendations, and answers in ten languages.

10ML Perfume Finder is a free MCP server that gives AI assistants a working knowledge of fragrance. Once the single endpoint is added to a client such as Claude, ChatGPT, Cursor, VS Code or Gemini CLI, the assistant can call 15 read-only tools while it answers. The underlying Fragrance Index is described as holding more than 6,000 perfumes, each with its house, year, family, accords, note pyramid, seasons and occasions. No API key, account or sign-up is required, and the tools set no cookies and keep no request history. The tools map to the questions people actually ask about scent. search_perfumes finds bottles by name, house, note, accord, family, season or occasion using plain language. get_perfume returns a full profile, compare_perfumes puts two to four fragrances side by side with shared notes and differences, and find_similar_perfumes and find_perfume_alternatives surface scents that resemble a favourite, with the reasoning behind each match. recommend_perfumes builds picks from stated likes and dislikes plus season and occasion, while pick_for_occasion and find_gift handle narrower briefs. A second group is educational: explain_note, explain_perfume_term, get_house, list_houses and suggest_layering cover vocabulary, houses and layering combinations. search_guides pulls from 10ML written guides and accepts a locale across ten languages, and non-English note names are understood too. It suits anyone who already asks an assistant for scent advice and wants sourced answers instead of guesses: shoppers comparing designer releases, collectors hunting niche houses, and gift buyers who do not know where to start. Setup is a URL paste in most clients, with one click installs for Cursor and VS Code and a stdio package for Windsurf, Cline, Goose and Zed. 10ML also publishes its own 40-question benchmark claiming the highest accuracy and lowest latency among keyless perfume MCP servers, though that comparison is self-reported. A REST API is offered separately for code that needs the raw data. Where it fits: it is a lookup and reasoning layer, not a shop. Larger indexes exist for rare and obscure bottles, so breadth is the trade-off against speed and accuracy. Lists are paginated, fair-use rate limiting may apply, and heavy jobs should be cached, since REST responses carry a five-minute cache header.

How do you use 10ML Perfume Finder?

  1. 1Pick your client and copy the endpoint
    Every supported client uses the same address: https://mcp.10ml.com/mcp. The setup page lists the exact steps and JSON snippets for Claude, ChatGPT, Cursor, VS Code, Gemini CLI and others.
    10ML Perfume Finder — Pick your client and copy the endpoint
  2. 2Add the connector in Claude or ChatGPT
    In Claude, open Customize then Connectors and add 10ML Perfume Finder from the directory, or choose Add custom connector and paste the URL. In ChatGPT on the web, open Plugins, add a custom MCP server, name it and choose no authentication.
  3. 3Install in Cursor or VS Code in one click
    Use the install buttons on the setup page, or drop the provided JSON into ~/.cursor/mcp.json or .vscode/mcp.json. Command line users can run the Claude Code or Gemini CLI add command instead.
  4. 4Ask a first perfume question
    Type a normal request such as what smells like Creed Aventus, or a brief like a fresh summer office scent for men. The assistant selects the matching tool and answers with notes, close matches and a link to the full guide.
  5. 5Read the guides and browse the catalogue
    Answers point back to 10ML note pages and guides, and the shop carries decants in 3ml, 10ml and 30ml if you want to test a recommendation before committing to a full bottle.
    10ML Perfume Finder — Read the guides and browse the catalogue

Pros and cons

Pros

  • No API key, account or sign-up: paste one URL and the assistant starts calling toolsAI
  • 15 focused tools cover comparison, alternatives, notes, houses, layering and gifting, not just searchAI
  • Ten supported languages, with non-English note names understood (Vanille resolves to vanilla)AI
  • Read-only endpoints with no cookies or request history, and one click installs for Cursor and VS CodeAI
  • Published benchmark shows one tool call per question and a median 232 ms responseAI

Cons

  • The 40-question benchmark is run and published by 10ML itself, so the accuracy lead is not independently verifiedAI
  • Smaller index than some rivals, which claim far larger catalogues for rare and obscure bottlesAI
  • Only usable inside an MCP-capable client; there is no standalone web interface for direct browsingAI
  • Fair-use rate limiting can throttle bulk queries, and paginated lists mean caching work falls to the userAI

How much does 10ML Perfume Finder cost?

Pricing

Free to use, with no API key, no account and no sign-up. Every endpoint is read-only, and fair-use rate limiting may apply under the terms. A separate REST API serves the same index for code that needs raw data.

Learn more

Integrations

Connects to Claude (web and Desktop), Claude Code, ChatGPT, Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose and Zed. Most clients take the single URL; the others use the stdio package via npx or uvx.

Features

15 read-only tools: perfume search by name, house, note, accord, family, season or occasion; full profiles with note pyramids; side by side comparison of two to four scents; similar scent and alternative finding; taste-based recommendations; occasion and gift picks; note, house and terminology explainers; layering suggestions; and guide search across ten languages.

Frequently asked questions about 10ML Perfume Finder

  • How much does 10ML Perfume Finder cost?
    Free to use, with no API key, no account and no sign-up. Every endpoint is read-only, and fair-use rate limiting may apply under the terms. A separate REST API serves the same index for code that needs raw data.
  • Does 10ML Perfume Finder have an API?
    Yes, 10ML Perfume Finder offers an API.
  • How do you use 10ML Perfume Finder?
    The walkthrough on this page covers 5 steps: 1. Pick your client and copy the endpoint 2. Add the connector in Claude or ChatGPT 3. Install in Cursor or VS Code in one click 4. Ask a first perfume question 5. Read the guides and browse the catalogue.
  • What platforms does 10ML Perfume Finder support?
    10ML Perfume Finder is available on Web App, MacOS, Windows, Linux, Browser extension and Chrome OS.
  • What does 10ML Perfume Finder integrate with?
    Connects to Claude (web and Desktop), Claude Code, ChatGPT, Cursor, VS Code, Gemini CLI, Windsurf, Cline, Goose and Zed. Most clients take the single URL; the others use the stdio package via npx or uvx.
  • What are the limitations of 10ML Perfume Finder?
    The 40-question benchmark is run and published by 10ML itself, so the accuracy lead is not independently verified. Smaller index than some rivals, which claim far larger catalogues for rare and obscure bottles. Only usable inside an MCP-capable client; there is no standalone web interface for direct browsing.

Status

StatusActive
Views0
Outbound clicks0
Added10/22/2026

Platforms

Web AppMacOSWindowsLinuxBrowser extensionChrome OS

Pricing

Free