Log inSubmit server
10ML Fragrance Index logo

10ML Fragrance Index

Searches 10ML’s fragrance database for perfume facts, comparisons, recommendations, alternatives, layering ideas and guides.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install 10ML Fragrance Index

Pick your client, then add it in one click or paste the config.

Streamable HTTP (Remote)
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "10ml-fragrance-index": {
      "command": "npx",
      "args": [
        "-y",
        "@10ml/perfume-finder-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Hosted endpointLive · 3d agoLive Remote EndpointOur automated health check connected to this remote MCP endpoint successfully.Last checked 10/25/2026, 7:30:34 PM

Clients with native remote MCP support can connect directly to this URL.

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

Automated check passed— started and listed 15 tools correctly (4d ago).

Overview

10ML Fragrance Index MCP server connects AI clients to 10ML’s read-only fragrance database through 15 tools. It supports natural-language searches, detailed perfume and house profiles, comparisons, recommendations, note explanations, layering suggestions, gift ideas and editorial guides. Use it when an agent needs structured perfume knowledge, discovery by scent characteristics or links to 10ML reference content. The hosted Streamable HTTP endpoint requires no authentication, while local stdio runners are available through npm and PyPI.

Use cases

  • Search for fragrances by notes, season, audience or occasion
  • Compare two to four named perfumes
  • Find similar scents or alternatives from other houses
  • Explain fragrance notes, families and terminology
  • Recommend perfumes, gifts or layering combinations

Key features

  • 15 read-only fragrance tools
  • Natural-language perfume search
  • Profiles for perfumes, notes and houses
  • Similarity, comparison and alternative matching
  • Layering, gifting and occasion recommendations
  • Streamable HTTP and stdio access

Tools15

What 10ML Fragrance Index lets your agent do. Expand a tool for its parameters.

Verified live~6.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

What it can do

From the 15 tools this server returned when we ran it; 15 declare their own safety hints.

Makes network requests · 1Read-only tools · 15
Tool definitions changed on 2026-10-24. Review them if you approved this server earlier.
Network at startup5 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age4 days
Maintainers1

Observed 2026-10-24 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @10ml/perfume-finder-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads454Package downloads in the last 30 days.
Last commit8d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed15Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How 10ML Fragrance Index works

What 10ML Fragrance Index MCP server does

10ML Fragrance Index MCP server gives an MCP client access to 10ML’s curated perfume database and editorial content. The index covers more than 5,400 designer, niche and Middle-Eastern fragrances, 249 houses, 285 explained notes and 164 guides in ten languages. Coverage varies: 481 perfumes have full editorial profiles, while other entries provide core information such as notes, accords and a character description.

The service is read-only and intended for research, discovery and recommendation workflows. It can return perfume facts, compare named fragrances, find similar scents, identify alternatives from other houses, explain perfume terminology and point users to relevant 10ML pages.

How it works

The hosted service uses the Streamable HTTP endpoint https://mcp.10ml.com/mcp. No sign-in or authentication is required. Requests can use a locale from the supported language set so labels and 10ML links match the selected locale. Tools also accept a response format of concise or detailed where applicable.

Search and discovery tools distinguish between different intents. Use search_perfumes for filters or natural-language descriptions, get_perfume for one known fragrance, and compare_perfumes for two to four named fragrances. Similarity, editorial alternatives and taste-based recommendations are separate operations, allowing an agent to choose between “smells like,” “dupe of,” and “I like these notes” requests.

Results are structured with an output schema and also include a short text summary. List-style results support pagination with limit and cursor. The package also exposes prompts and MCP resources for fragrance families, terminology, notes, houses and individual perfume records.

Setup and configuration

Clients that accept a remote MCP URL can connect directly to https://mcp.10ml.com/mcp; there is no local installation step. For clients that launch a process over stdio, use Node.js 18+ with npx -y @10ml/perfume-finder-mcp, or Python 3.10+ with uvx perfume-finder-mcp.

The repository documents configurations for Claude Desktop, Cursor, Windsurf, Cline, Zed, Claude Code, VS Code and Gemini CLI. Claude Code can add the HTTP endpoint with claude mcp add --transport http. VS Code uses an HTTP server entry, while Gemini CLI can install the GitHub extension. The same endpoint is also available through the documented REST API for agents that do not use MCP.

Tools and capabilities

The 15 read-only tools cover:

  • Searching by perfume name, house, notes, accords, family, audience, season, occasion or style.
  • Retrieving full perfume and house profiles, including note pyramids, launch data, longevity, projection and perfumers where available.
  • Comparing fragrances and finding similar scents with optional steering such as fresher, sweeter, darker, lighter, longer-lasting or more projection.
  • Finding editor-selected alternatives, recommendations based on preferences, occasion picks and gift ideas.
  • Exploring perfumes by note, explaining notes and perfume vocabulary, and suggesting layering combinations.
  • Finding 10ML guides and links for further reading or citation.

Limitations and notes

The 10ML Fragrance Index MCP server does not provide write operations, account access or authentication. Similarity and alternative results are different: the former matches shared notes, accords and style, while the latter focuses on alternatives from other houses and includes an editorial guide when available. Unknown perfume names return closest matches through get_perfume.

The iconic option on search_perfumes limits results to classics selected by 10ML’s editors. Older iconic_perfumes and trending_perfumes names remain aliases for existing integrations, but are not listed tools. Layering results marked as suggested should be tested on skin; editorial pairings are identified separately.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about 10ML Fragrance Index

10ML Fragrance Index is an MCP server that connects AI clients to 10ML’s curated perfume database and editorial guides. Its main tools search fragrances, retrieve perfume and house profiles, compare scents, find similar perfumes and alternatives, explain notes and terms, recommend gifts or occasions, and suggest layering combinations.

You do not need to install it when your client accepts remote MCP URLs; connect to https://mcp.10ml.com/mcp. For local stdio use, run the npm package with Node.js 18+ or the PyPI package with Python 3.10+ via npx or uvx.

Yes, 10ML Fragrance Index works with Cursor through its remote Streamable HTTP endpoint. Add https://mcp.10ml.com/mcp in Cursor’s MCP settings, or use the repository’s Add to Cursor link.

Yes, use find_perfume_alternatives to find editorial alternatives from other houses. It covers about 100 iconic originals and computes close options for other indexed fragrances using notes and accords.

No, the hosted MCP endpoint is free, read-only and requires no sign-in or authentication. Connect clients directly to https://mcp.10ml.com/mcp.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG Preview10ML Fragrance Index AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/10ml-fragrance-index?style=directory)](https://allmcps.com/mcp/10ml-fragrance-index)
HTML Embed
<a href="https://allmcps.com/mcp/10ml-fragrance-index"><img src="https://allmcps.com/api/badge/10ml-fragrance-index?style=directory" alt="10ML Fragrance Index on AllMCPs" /></a>