com.10ml/perfume-finder

up checked 2026-11-11T03:38:03.897Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

10ML Perfume Finder

Publisher-provided description

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

Summary by lookupd

Search and compare perfumes, notes and fragrance houses, get alternatives and gift or occasion picks from a fragrance index of 6,000+…

Install

Claude Code, remote (streamable-http)

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

Claude Code, npm package (stdio)

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

Claude Code, pypi package (stdio)

claude mcp add perfume-finder -- uvx perfume-finder-mcp

Claude Code, npm package (stdio)

claude mcp add perfume-finder -- npx -y perfume-mcp

Claude Code, pypi package (stdio)

claude mcp add perfume-finder -- uvx perfume-mcp

Codex, remote (streamable-http)

codex mcp add perfume-finder --url https://mcp.10ml.com/mcp

Codex, npm package (stdio)

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

Codex, pypi package (stdio)

codex mcp add perfume-finder -- uvx perfume-finder-mcp

Codex, npm package (stdio)

codex mcp add perfume-finder -- npx -y perfume-mcp

Codex, pypi package (stdio)

codex mcp add perfume-finder -- uvx perfume-mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Cursor, npm package (stdio) → .cursor/mcp.json

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

Cursor, pypi package (stdio) → .cursor/mcp.json

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

Cursor, npm package (stdio) → .cursor/mcp.json

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

Cursor, pypi package (stdio) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (15 tools)

Publisher-provided 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
• get_perfume The full Fragrance Index profile of one perfume, cologne or fragrance: house, launch year, audience, concentration, family, accords, note pyramid (top, heart an
• 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 p
• 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 c
• 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 spi
• 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 fam
• 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, s
• 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
• 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 perfum
• list_houses Browse the perfume houses and fragrance brands in the 10ML Fragrance Index with country, type (designer, niche, middle-eastern, indie, celebrity), perfumes prof
• explain_perfume_term Explain perfume vocabulary and fragrance families: concentrations (eau de cologne, eau de toilette, eau de parfum, extrait, elixir), sillage, projection, longev
• 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. Wo
• 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 wi
• 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,
• 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 guide

Details

• Version: 2.6.1
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 741 ms
• First indexed: 2026-11-01T08:52:32.460Z
• Last seen in registry: 2026-11-07T00:17:14.204Z
• Repository: https://github.com/10ml-com/perfume-finder-mcp
• Website: https://mcp.10ml.com

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/com.10ml/perfume-finder.svg)](https://lookupd.com/servers/com.10ml/perfume-finder)

• 62141 servers
• Last crawl: 2026-11-11T18:39:04.612Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp