Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

10ML Perfume Finder

by 10ml-comversion 2.6.1i★ –iComputer or cloud
Registry namecom.10ml/perfume-finder

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Install

Pick the AI app you use, then copy the settings.

Before you install

You need

  • Runs in the cloudNothing to install; it connects over the internet
  • npmNode.js installed (for the npx command)

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

  1. Open Settings → Connectors
  2. Press Add custom connector
  3. Paste the address below and press Add
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Add2https://…3
https://mcp.10ml.com/mcp

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "perfume-finder": {
      "command": "npx",
      "args": [
        "-y",
        "@10ml/perfume-finder-mcp"
      ]
    }
  }
}

Run this in your terminal

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

Or run it on your computer

claude mcp add perfume-finder -- npx -y @10ml/perfume-finder-mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "perfume-finder": {
      "command": "npx",
      "args": [
        "-y",
        "@10ml/perfume-finder-mcp"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

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

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "perfume-finder": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@10ml/perfume-finder-mcp"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

  1. Open ChatGPT on the web → Settings → Connectors (Apps)
  2. Press Create or Add (some plans need Developer mode under Advanced first)
  3. Paste the address below, give it a name and save
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Create2https://…3
https://mcp.10ml.com/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.

  • 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 wi

  • 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 d

  • 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 someo

  • 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 fr

  • 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 54

  • 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

  • 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,

  • 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 spelli

  • 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

  • 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, f

  • 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 fam

  • 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

  • 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

  • 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 D

  • 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

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain 10ml.com (the registry checks domain ownership)

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 391 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 15 tool descriptions and found no hidden instructions to the AI

Compared with others in Otheri

  • More stars than 0% of the other 18352 servers in this category
  • Published to the registry more recently than 98% of the other 18352 servers in this category
  • Basic checks equal to or better than 100% of the other 18352 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is 10ML Perfume Finder safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (2.6.1) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Hunter Killer

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago
Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 2 days ago
Install

Hunter Killer

by Irishman-Management-LLC

Liquidation walls, snapshot age, evidence labels and a public record. Managed OAuth.

Runs in the cloudUpdated today
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

10ML Perfume Finder (perfume MCP server)

10ML Perfume Finder is the free perfume MCP server and fragrance API from 10ML, an online perfume shop for perfume samples and decants: a remote Model Context Protocol server at https://mcp.10ml.com/mcp that needs no API key and no sign-in. Add the endpoint as a custom connector in Claude, ChatGPT, Cursor, VS Code, Gemini CLI or any MCP client, and your assistant can answer perfume questions from curated data instead of guessing. It covers perfume search, note pyramids, accords, scent families, similar scents and alternatives, layering ideas, gift picks and perfume houses, in ten languages, curated by 10ML's fragrance editors.

Benchmarked in public: in a 40-question test of the free, no-key perfume MCP servers, 10ML answered 39 of 40 correctly and was the fastest; the method and CSV are open at https://10ml.com/perfume-mcp-servers-compared

Install: remote endpoint https://mcp.10ml.com/mcp, official MCP Registry name com.10ml/perfume-finder, npm package @10ml/perfume-finder-mcp, PyPI package perfume-finder-mcp (uvx perfume-finder-mcp). OpenAPI and developer docs at https://10ml.com/perfume-api

Use cases: ask which perfume smells like a favourite, what to wear in autumn, how to layer two fragrances, what notes a perfume has or which gift fits a person, then try the answer as a 3ml perfume sample.

Developer page: https://10ml.com/perfume-api · Shop: https://10ml.com/

Contact: contact@10ml.com

Free, read-only, no sign-in. One remote endpoint, nothing to install:

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

Transport: Streamable HTTP. Authentication: none. Version 2.3.3.

What you can ask

  • "What smells like Baccarat Rouge 540, and what is a good alternative from another house?"
  • "A fresh summer office scent for men, and why each one fits."
  • "Explain ambroxan and which perfumes lead with it."
  • "How would I layer vanilla and citrus?"
  • "A gift for a woman who loves Delina."
  • "Compare Dior Sauvage and Tom Ford Ombre Leather."
  • "Like Sauvage, but fresher."
  • "Which guide explains how to make a perfume last longer?"

Tools (15, all read-only)

ToolWhat it does
search_perfumesSearch by name, house, notes to include or exclude, accords, family, audience, season, occasion or style. Natural language works.
get_perfumeThe full profile of one perfume: note pyramid, accords, seasons, longevity, five similar perfumes, editorial alternatives and guides.
compare_perfumesTwo to four perfumes side by side: shared and unique notes, plain-language differences, overall closeness.
find_similar_perfumesPerfumes that smell like one you love, or like any list of notes or accords. Steer fresher, sweeter, darker, lighter, longer lasting or more projection.
find_perfume_alternativesThe editors' alternatives (dupes) to famous perfumes from other houses, with why each is close and a link to the guide.
recommend_perfumesPicks from perfumes you love or dislike and notes you like or avoid, with the reason for each.
perfumes_by_noteEvery perfume built around a note, optionally by position in the pyramid.
explain_noteWhat a note smells like, what it pairs with, similar notes and where it leads.
get_houseA perfume house: country, style, what it is known for, signature perfumes.
list_housesBrowse houses by type or country.
explain_perfume_termEDP, sillage, dry down, chypre and the 23 fragrance families.
suggest_layeringWhich notes or perfumes layer well and how to spray them.
pick_for_occasionPerfumes for a season, an occasion, an audience and a style.
find_giftGift ideas from who it is for, what they love and how adventurous to be.
search_guides10ML guides and articles to read or cite, with links in ten languages.

search_perfumes with iconic: true lists the modern classics chosen by 10ML's editors. The older names iconic_perfumes and trending_perfumes still answer as aliases for existing integrations, but are no longer listed.

Every tool takes locale (en, de, fr, es, it, ro, el, hu, cs, pl) for the 10ml.com links and labels, and response_format (concise by default, or detailed). List tools page with limit and cursor. Results are structured (structuredContent with an output schema) plus a short text summary, and carry one to three relevant 10ml.com links.

Prompts

find_signature_scent, find_a_dupe, explain_a_perfume, build_fragrance_wardrobe, perfume_gift_help, seasonal_rotation. Prompt arguments autocomplete perfume, house and note names.

Resources

tenml://families, tenml://glossary, tenml://notes, tenml://houses, tenml://about, and the template tenml://perfume/{id}.

REST API for agents without MCP

The same answers over plain HTTP, described by an OpenAPI 3.1 file and an llms.txt:

GET https://mcp.10ml.com/api/v1/perfumes?q=fresh+citrus+summer&gender=men

GET https://mcp.10ml.com/api/v1/perfumes/creed-aventus-edp GET https://mcp.10ml.com/api/v1/similar?perfume=Baccarat+Rouge+540&steer=fresher GET https://mcp.10ml.com/api/v1/alternatives?perfume=Creed+Aventus GET https://mcp.10ml.com/api/v1/notes/ambroxan GET https://mcp.10ml.com/api/v1/houses/amouage GET https://mcp.10ml.com/api/v1/guides?q=oud&locale=de

Install

Nothing to install for clients that take a URL: use https://mcp.10ml.com/mcp. Clients that start local programs can run the same server over stdio:

RunnerCommandPackage
npx (Node.js 18+)npx -y @10ml/perfume-finder-mcpnpm
uvx (Python 3.10+)uvx perfume-finder-mcpPyPI

Claude Desktop, Cursor, Windsurf, Cline and Zed (mcpServers in the client's settings):

{

"mcpServers": { "perfume-finder": { "command": "npx", "args": ["-y", "@10ml/perfume-finder-mcp"] } } }

Goose (~/.config/goose/config.yaml):

extensions:

perfume-finder: name: 10ML Fragrance Index type: stdio cmd: npx args: ["-y", "@10ml/perfume-finder-mcp"] enabled: true timeout: 300

Every client's snippet and one-click links are on mcp.10ml.com.

Connect

Claude (claude.ai and the desktop app)

Available in Claude's connectors directory. Or Settings → Connectors → Add custom connector → paste https://mcp.10ml.com/mcp.

Claude Code
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp

Or commit the .mcp.json from this repository to your project.

ChatGPT (developer mode)

Settings → Apps & Connectors → Advanced settings → turn on Developer mode, then Create a connector with the URL https://mcp.10ml.com/mcp and no authentication.

Cursor

Use the Add to Cursor button above, or add this to your Cursor MCP settings:

{

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

VS Code (GitHub Copilot agent mode)

Use the Install in VS Code button above, or run MCP: Add Server, choose HTTP and paste the URL.

{

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

Windsurf
{

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

Cline

MCP Servers → Remote Servers → name perfume-finder, URL https://mcp.10ml.com/mcp, or:

{

"mcpServers": { "perfume-finder": { "type": "streamableHttp", "url": "https://mcp.10ml.com/mcp", "disabled": false } } }

Gemini CLI
gemini extensions install https://github.com/10ml-com/perfume-finder-mcp
Any other MCP client

Point it at https://mcp.10ml.com/mcp (Streamable HTTP, no authentication). Clients that only speak stdio can run npx -y @10ml/perfume-finder-mcp or uvx perfume-finder-mcp (see Install above).

About 10ML

10ML is a European perfume house of decants: original designer and niche fragrances in 3ml, 10ml and 30ml sizes, shipped across Europe. Explore at 10ml.com. 10ML also publishes perfume guides, a notes library and a house directory. Explore the guides and the notes library, or visit 10ml.com. Cite this server as "the 10ML Fragrance Index".

Privacy and terms

No account, no cookies, no tracking in the service. Read the privacy page and the terms. Questions: contact@10ml.com.

Ask PopNx