# 10ML Perfume Finder

Gives your agent a fragrance database of 5,400+ perfumes and 285 notes: similar scents, side-by-side comparison, occasion picks. Handy for anything scent-related.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: 10ml-com
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/10ml-com/perfume-finder-mcp
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/10ml-perfume-finder

## What it does

The server speaks Streamable HTTP at a single address, `https://mcp.10ml.com/mcp`. No sign-in, no API key, read-only. Fifteen tools sit behind it. `search_perfumes` matches on name, house, notes, accords and family, `get_perfume` returns the note pyramid plus five similar scents, and `compare_perfumes` lines up two to four bottles and shows which notes they share and which they do not.

Other calls cover everyday questions: `find_gift` builds a present from what someone likes, `suggest_layering` says what to spray with what, `pick_for_occasion` narrows by season and setting. Six prompts ship alongside, among them `find_signature_scent` and `build_fragrance_wardrobe`. Every tool takes `locale` for links and labels — `en`, `de`, `fr`, `es`, `it`, `ro`, `el`, `hu`, `cs`, `pl`.

Clients that launch local processes can run the same server over stdio: `npx -y @10ml/perfume-finder-mcp` on Node.js 18+, or `uvx perfume-finder-mcp` on Python 3.10+. The names `iconic_perfumes` and `trending_perfumes` still answer as aliases for older integrations, though they no longer appear in the tool list — if your setup calls them, move to `search_perfumes` with `iconic: true`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.10ml.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add 10ml-perfume-finder -- npx -y @10ml/perfume-finder-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add 10ml-perfume-finder --url https://mcp.10ml.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add 10ml-perfume-finder -- npx -y @10ml/perfume-finder-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "10ml-perfume-finder": {
            "url": "https://mcp.10ml.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "10ml-perfume-finder": {
            "command": "npx",
            "args": [
                "-y",
                "@10ml/perfume-finder-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "10ml-perfume-finder": {
            "type": "http",
            "url": "https://mcp.10ml.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "10ml-perfume-finder": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@10ml/perfume-finder-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http 10ml-perfume-finder https://mcp.10ml.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add 10ml-perfume-finder npx -y @10ml/perfume-finder-mcp
```

## When to use it
- find a scent close to a favourite but fresher
- compare two perfumes by shared and unique notes
- explain what ambroxan smells like and where it leads
- pick a gift from someone's taste
- get layering ideas for vanilla and citrus

## Example prompts
- Find a fresh summer office scent for men and explain why each one fits
- Compare two perfumes by their note pyramids and tell me what they share

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md