10ML Perfume Finder (perfume MCP server, stdio)

10ML Perfume Finder is the free perfume MCP server and fragrance API, powered by the 10ML Fragrance Index and curated by the fragrance editors of 10ML: 5,400+ designer, niche and Middle-Eastern perfumes and 249 houses (481 full editorial profiles with longevity, projection and perfumers, the rest as core profiles with notes, accords and character), 285 notes explained, editorial alternatives to famous perfumes, layering ideas and 164 guides in ten languages. In our 40-question benchmark of free perfume MCP servers (20 October 2026) it was the most accurate and the fastest: 39 of 40 correct, one call per question, median 232 ms.

Free, read-only, no sign-in, no API key. This package runs the 10ML Fragrance Index over stdio, so desktop clients that start local commands (Claude Desktop, Cursor, Goose, Windsurf, Cline, Zed) can use it with one line (uvx perfume-finder-mcp). The same server is also reachable directly over Streamable HTTP at https://mcp.10ml.com/mcp, with nothing to install.

Quick start

uvx perfume-finder-mcp

Or install it with pipx install perfume-finder-mcp / pip install perfume-finder-mcp and run perfume-finder-mcp.

Claude Desktop

Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "perfume-finder": {
      "command": "uvx",
      "args": ["perfume-finder-mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "perfume-finder": {
      "command": "uvx",
      "args": ["perfume-finder-mcp"]
    }
  }
}

Goose

goose configure   # Add Extension → Command-line Extension
# command: uvx perfume-finder-mcp

Or in ~/.config/goose/config.yaml:

extensions:
  perfume-finder:
    name: 10ML Fragrance Index
    type: stdio
    cmd: uvx
    args: ["perfume-finder-mcp"]
    enabled: true
    timeout: 300

Windsurf, Cline, Zed and other clients

Use the same command and args as above in the client's MCP settings. Clients that accept a URL can skip this package: https://mcp.10ml.com/mcp (Streamable HTTP, no authentication).

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?"
• "Compare Dior Sauvage and Tom Ford Ombre Leather."

Tools (15, all read-only)

search_perfumes, get_perfume, compare_perfumes, find_similar_perfumes, find_perfume_alternatives, recommend_perfumes, perfumes_by_note, explain_note, get_house, list_houses, explain_perfume_term, suggest_layering, pick_for_occasion, find_gift, search_guides (search_perfumes with iconic: true lists the editors' iconic classics). Plus six prompts and the tenml:// resources (families, glossary, notes, houses, about, one profile per perfume). Every tool takes locale (en, de, fr, es, it, ro, el, hu, cs, pl) and response_format (concise or detailed).

Full documentation: mcp.10ml.com and github.com/10ml-com/perfume-finder-mcp.

How it works

The package starts a small stdio MCP server and passes each request to https://mcp.10ml.com/mcp, which answers it. It needs internet access and Python 3.10 or newer, and it stores nothing on your machine. Cite the answers as "the 10ML Fragrance Index".

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.

Privacy · Terms · contact@10ml.com · MIT license