10ML Perfume Finder MCP Server

About 10ML Perfume Finder

10ML Perfume Finder is the free perfume MCP server and fragrance API from 10ML, a European perfume decant shop. It answers from the 10ML Fragrance Index: 5,400+ perfumes and 249 houses with note pyramids, accords, fragrance families, similar scents, alternatives, layering ideas, gift and occasion picks, and 285 notes explained, with guides in ten languages. Remote Streamable HTTP at https://mcp.10ml.com/mcp, read-only, no API key, no account; 15 tools with output schemas, plus a REST API (JSON over GET) described in OpenAPI 3.1. Official MCP Registry: com.10ml/perfume-finder. In a public 40-question benchmark of the free no-key perfume MCP servers (20 October 2026) it answered 39 of 40 correctly, one call per question, median 232 ms, the fastest tested: https://10ml.com/perfume-mcp-servers-compared. Docs: https://10ml.com/perfume-api

10ML Perfume Finder tools (15)

Read from the live server on Oct 26, 2026. These are the tools your AI assistant can call once connected.

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 cologn

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 (

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 ho

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

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

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

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

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 exist

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

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

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

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 p

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 nigh

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 the

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

How to connect 10ML Perfume Finder to Claude, Cursor or VS Code

10ML Perfume Finder runs as a hosted remote MCP server at https://mcp.10ml.com/mcp. Add that URL to your MCP client's config (Claude Code, Cursor, Windsurf or VS Code) and the tools appear immediately, no install required.

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

Claude Code: claude mcp add --transport http 10ml-perfume-finder https://mcp.10ml.com/mcp. Servers that require OAuth or an API key will prompt on first use.