Skip to content
MCP server

10ML Perfume Finder

Free perfume search, notes and similar-scent lookup for AI assistants

Install
Pricing
Free
Platforms
API, CLI
Runs
Locally or Remotely
Version
2.6.1
Listing updated
3 days ago

About 10ML Perfume Finder

10ML Perfume Finder is a free MCP server for e-commerce. It can run locally on your machine or as a hosted remote server.

Behind the server is the 10ML Fragrance Index, which the site puts at 6,018 perfumes and 249 houses, each with a note pyramid, accords and family. A smaller set of 481 editorial profiles adds longevity, projection and perfumers. The operator, 10ML, is an online shop for perfume samples and decants, and answers link to its own guide and note pages in seventeen languages.

The server exposes 15 read-only tools, 6 prompts, resources and completions. Typical questions are what smells like a favourite, how to layer two scents, what a note like ambroxan is, or how two perfumes compare. Editors' alternatives (dupes) come with the reason each is close.

It connects as a remote Streamable HTTP endpoint with no key or sign-in, or runs locally over stdio through npm or PyPI. The vendor reports its own 40-question benchmark, which should be read as a vendor claim.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.10ml.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "perfume-finder": {
      "url": "https://mcp.10ml.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

search_perfumes
Find perfumes by name, notes, accords, family, audience, season, occasion or style.
get_perfume
Full profile of one perfume with similar perfumes, alternatives and guides.
compare_perfumes
Two to four perfumes side by side.
find_similar_perfumes
Perfumes that smell like one you love or like a list of notes.
find_perfume_alternatives
Editors' alternatives to famous perfumes from other houses.
recommend_perfumes
Picks from what you love, dislike and avoid, with reasons.
perfumes_by_note
Every perfume built around a note.
explain_note
What a note smells like and what it pairs with.
get_house
A perfume house: country and style.

What it does

Perfume search
Find perfumes by name, notes, accords, family, audience, season or occasion.
Side-by-side comparison
Compare two to four perfumes on shared notes and differences.
Similar scents
Find perfumes close to one you love, steered fresher, sweeter or darker.
Editor alternatives
Editors' alternatives to famous perfumes from other houses.
Note explainers
What a note smells like, what it pairs with and which perfumes lead with it.
No key needed
One URL, read-only, no sign-in.

Good for

  • Ask for a perfume similar to a favourite
  • Compare two fragrances before buying
  • Find a gift perfume from the recipient's favourite
  • Learn what a perfume note smells like
  • Get layering ideas for two scents

Pricing

Free

Free, no key or sign-in

Prices change. Check mcp.10ml.com before you buy.

10ML Perfume Finder FAQ

Do I need an API key?

No. The remote endpoint needs no key or sign-in.

Can it change anything?

No. All 15 tools are read-only.

How can I run it locally?

Use npx -y @10ml/perfume-finder-mcp or uvx perfume-finder-mcp.

Which clients work?

Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline and other MCP clients.

Is 10ML Perfume Finder free?

Yes. 10ML Perfume Finder is free to use.

How do I add 10ML Perfume Finder to Claude Code?

Run this command in your terminal: claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp

What are the best alternatives to 10ML Perfume Finder?

The closest alternatives to 10ML Perfume Finder are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

Alternatives to 10ML Perfume Finder

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data