mcpbeat Sign in

10ML Perfume Finder MCP Server

answering

10ML Perfume Finder is answering right now. Last checked 6 min ago. 4 305 installs a week from pypi. It exposes 15 tools. Last commit 20 Oct 2026.

Free perfume MCP server and fragrance API: 6,000+ perfumes, note pyramids, accords, similar scents.

Installs per day peak 388 · avg 12
a month agotoday
Uptime history 7 days of history
7 days agonow
100.0%
Uptime 24h
91 of 91 checks
15
Tools
read from the server
573 ms
Response time
average over 24h
4 305
Installs / week
npm and PyPI

What changed 77

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 20 October 2026. No other catalogue keeps this.

22 Oct 15 tools changed the parameters they ask for30 times that day compare_perfumes, explain_note, explain_perfume_term and 12 more
22 Oct a tool changed version3 times that day
21 Oct 15 tool descriptions were rewritten compare_perfumes, explain_note, explain_perfume_term and 12 more
21 Oct 15 tools changed the parameters they ask for compare_perfumes, explain_note, explain_perfume_term and 12 more
21 Oct a tool changed version2 times that day
20 Oct a tool changed version6 times that day
20 Oct 4 tool descriptions were rewritten find_gift, get_perfume, pick_for_occasion and 1 more
20 Oct a tool disappeared iconic_perfumes
20 Oct a tool changed the parameters it asks for search_perfumes
and 23 more, back to 20 October 2026

What the code does

We read the source, 2 d ago · tools taken from the live server · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] src/perfume_finder_mcp/__init__.py:1, [пакет] src/perfume_finder_mcp/__main__.py:1
этот файл ставится пользователю, но в репозитории его нет

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 6 min ago.

run in your terminal
claude mcp add perfume-finder --transport http https://mcp.10ml.com/mcp
Settings → Connectors → Add custom connector, then paste this address
https://mcp.10ml.com/mcp
~/.codex/config.toml
[mcp_servers.perfume-finder]
url = "https://mcp.10ml.com/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "perfume-finder": {
      "url": "https://mcp.10ml.com/mcp"
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "perfume-finder": {
      "type": "http",
      "url": "https://mcp.10ml.com/mcp"
    }
  }
}

Available tools 15

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

explain
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).
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).
perfume
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).
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.
perfumes
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).
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.
compare
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).
gift
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).
guides
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).
house
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).
houses
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).
pick
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).
recommend
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).
similar
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).
suggest
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).

Tools removed

Tools this server used to expose. Anything built against them stopped working on the day they went.

iconic_perfumes
removed 20 Oct 2026

Endpoints

URLTransportStateLatencyChecked
https://mcp.10ml.com/mcp streamable-http answering 454 ms 6 min ago

Alternatives to 10ML Perfume Finder

same job, measured the same way
Scento Perfume API (MCP server)
by scento

Free perfume & fragrance API and MCP server: notes, families, similar scents, 1,400+ perfumes.

351 installs/wk 12 tools answering
Fragrances
by parfica

Fragrance encyclopedia: note pyramids, accords, perfumers and dupes (parfica.com).

16 installs/wk 3 tools answering
Perfume Picks
by bguillow-rgb

Search the Perfume Picks fragrance database: 10,000+ scents with notes, dupes, and wear data.

515 installs/wk 8 tools answering
Fragrance & Perfume MCP (Noteboxd)
by noteboxd

Fragrance & perfume MCP: search fragrances, notes, accords, brands, perfumers, reviews & charts.

24 installs/wk 27 tools answering
Instagram Profile MCP Server
by afanasenkoa

Instagram profiles for AI agents — followers, similar accounts, keyword and location search.

answering
Amazonads MCP
by cprice70

MCP server for Amazon Ads API - manage campaigns, keywords, bids, and performance reports

23 installs/wk local only
VPNHub Free VPN MCP
by vpnhub

Find free VPN servers by country and protocol. Read-only access; no account or API key.

answering
Laudex
by laudex

Find MCP servers, APIs, tools and skills by intent. Free key: POST /api/agents/register

3 tools answering

10ML Perfume Finder — questions

Answers built from our own checks of this server.

What can 10ML Perfume Finder do?
It exposes 15 tools, read directly from the server on our last check. Among them: compare_perfumes, explain_note, explain_perfume_term, find_gift, find_perfume_alternatives, find_similar_perfumes and 9 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
What is 10ML Perfume Finder mostly used for?
Its tools cluster around perfumes, explain and perfume. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.
Is 10ML Perfume Finder working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 573 ms. The bar chart above shows every period we have measured.
Did 10ML Perfume Finder ever remove tools?
Yes. iconic_perfumes is no longer exposed — we recorded the date each one disappeared. A tool vanishing usually means a breaking change for anything that depended on it.
How do I connect 10ML Perfume Finder?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does 10ML Perfume Finder need an API key?
No. 10ML Perfume Finder completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 15 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is 10ML Perfume Finder?
It answers our handshake in 573 ms on average, which is faster than 22% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.
How many people use 10ML Perfume Finder?
The npm package perfume-mcp was installed 4 305 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is 10ML Perfume Finder open source?
The code is open source: it is published under the MIT licence, 0 stars on GitHub and 1 open issue. The licence covers the code in the repository, not the hosted service at mcp.10ml.com, which runs on its operator's own terms.