10ML Perfume Finder

by 10ml-teamco.huggingface.10ml-team/perfume-finder

Free perfume API and MCP server, no API key

  • Remote endpoint
  • 6 tools
  • MIT

Uptime

Checked  · every day

99.53%from 5 days of checks

Up without downtime on 0 of 4 days with data; down 20 minutes in all, the longest 6 minutes on 31 October.

  • No downtime
  • Degraded
  • Down over 5 minutes
  • No data
  • Not checked yet

Response time

Median 1115 ms, slowest 5% 1519 ms for the handshake and the tool list, over 30 days.

1500 ms750 ms0

How far each check got

  • Reached the address 75.0%
  • Completed the handshake 50.0%
  • Listed its tools 50.0%

6 tools at the last answer.

Every day
DayResultChecksMedian
3 Nov (today)No verdict yet0–
2 NovDown 6 minutes3of 11036 ms
1 NovDown 4 minutes1of 1–
31 OctDown 6 minutes3of 11115 ms
30 OctDown 4 minutes1–

A failure counts as down time only when a second check five minutes later fails too. How we check

Connect to the publisher's own endpoint

Run in a terminal:

codex mcp add perfume-finder --url https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

For agents: the install prompt

Every step above as one Markdown text, for an assistant installing it for you.

# Install the MCP server 10ML Perfume Finder (`co.huggingface.10ml-team/perfume-finder`)

Its page: https://plug.directory/servers/co.huggingface.10ml-team/perfume-finder

It runs on the publisher's servers; the client connects to its URL.

Use the section for the person's client.

## Claude Desktop

Paste into Settings › Connectors › Add custom connector:

```text
https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse
```

## Claude Code

Run in a terminal:

```sh
claude mcp add --transport sse perfume-finder https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse
```

## Cursor, Devin Desktop, LM Studio, Gemini CLI, oterm, ECA

Merge into the place for the person's client:

- Cursor: ~/.cursor/mcp.json
- Devin Desktop: ~/.config/devin/mcp_config.json
- LM Studio: mcp.json (Program › Install › Edit mcp.json)
- Gemini CLI: ~/.gemini/settings.json
- oterm: config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows)
- ECA: ~/.config/eca/config.json (global) or .eca/config.json in the project

```json
{
  "mcpServers": {
    "perfume-finder": {
      "url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

## VS Code

Merge into .vscode/mcp.json:

```json
{
  "servers": {
    "perfume-finder": {
      "type": "sse",
      "url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

## Zed

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## Cline, AnythingLLM, Augment Code

Merge into the place for the person's client:

- Cline: cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers)
- AnythingLLM: anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory
- Augment Code: Augment Settings Panel – MCP section – Import from JSON (VS Code extension)

```json
{
  "mcpServers": {
    "perfume-finder": {
      "type": "sse",
      "url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

## Continue

Merge into ~/.continue/config.yaml:

```yaml
mcpServers:
  - name: "perfume-finder"
    type: sse
    url: "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
```

## Goose

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## Codex

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## mcp-client-cli, TUUI, BoltAI, Bob Shell, Kiro, Kiro CLI

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## Agenvoy

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## Amp

Merge into ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):

```json
{
  "amp.mcpServers": {
    "perfume-finder": {
      "url": "https://10ml-team-perfume-finder.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

Then restart the client, or reload its MCP servers, and ask it to list the server's tools to confirm it started.

Tools 6

  • perfume_finder_compare_perfumes Use this when someone wants to compare two perfumes or colognes side by side, for example "Aventus or Sauvage" or "Delina versus Libre". Looks up both in the 10ML Fragrance Index and returns a markdown table comparing house, launch year, audience, family, accords, top, heart and base notes, seasons, occasions, longevity and projection, plus the notes and accords they share and 10ml.com links.
  • perfume_finder_explain_note Use this when someone asks what a fragrance note smells like, for example "what does oud smell like", "what is ambroxan" or "what goes with bergamot". Returns what the note smells like, its family and mood, other names for it, notes it pairs with, similar notes and famous perfumes where it leads, with 10ml.com links. Covers about 285 perfume notes, in many spellings and languages.
  • perfume_finder_perfume_alternatives Use this when someone wants alternatives to a famous perfume or cologne from other houses, or asks what smells like it from another house. Returns the 10ML fragrance editors' alternatives (dupes) for about 100 iconic originals such as Creed Aventus, Baccarat Rouge 540, Delina or Sauvage: for each one why it is close and how close (very close, similar vibe, same spirit), plus the 10ML guide that compares them.
  • perfume_finder_perfume_profile Use this when you know which perfume or cologne someone means and want to know what it smells like. Returns its full profile from the 10ML Fragrance Index: house, launch year, audience, fragrance family, accords, note pyramid (top, heart and base notes), best seasons and occasions, longevity, projection, perfumers, the editors' character description, similar scents and 10ml.com links. Suggests close matches when the name is not found.
  • perfume_finder_search_perfumes Use this when someone describes the fragrance they want or names a perfume, house or note and you need matching perfumes and cologne. Searches the 10ML Fragrance Index by free text (a name, a house, notes or a mood such as "fresh citrus summer scent for men" or "vanilla gourmand for winter"). Returns a markdown list of perfumes with house, year, audience, fragrance family, accords, key notes, a one-line character description and 10ml.com links.
  • perfume_finder_similar_perfumes Use this when someone likes one perfume or cologne and wants more that smell like it. Returns perfumes ranked by shared notes, accords and style, each with how close it is (very close, similar vibe, same spirit) and exactly what it shares. Can steer the result to be fresher, sweeter, darker, lighter, longer lasting or stronger in projection.

From Hugging Face Spaces. Report a problem