10ML Perfume Finder

https://github.com/10ml-com/perfume-finder-mcp
Admin
10ML Perfume Finder is a free, no-key remote MCP server and fragrance API that answers perfume...
Tokens:5,963
Snippets:56
Trust Score:4.2
License:MIT
Update:2 days ago
Show doc for...
Tokens:
Raw
### GET /api/v1/guides

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Search for fragrance guides by query. Returns a list of guides matching the query.

```APIDOC
## GET /api/v1/guides

### Description
Search for fragrance guides by query. Returns a list of guides matching the query.

### Method
GET

### Endpoint
/api/v1/guides

### Parameters
#### Query Parameters
- **q** (string) - Optional - Search query for guides.
- **locale** (string) - Optional - Locale for the guides (e.g., 'de').

### Request Example
```
GET https://mcp.10ml.com/api/v1/guides?q=oud&locale=de
```

### Response
#### Success Response (200)
Returns a list of guides.

#### Response Example
```json
[
  {
    "id": "string",
    "title": "string",
    "content": "string"
  }
]
```
```

--------------------------------

### Install perfume-finder MCP via Gemini CLI

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Use this command to install the perfume-finder MCP extension for Gemini CLI.

```bash
gemini extensions install https://github.com/10ml-com/perfume-finder-mcp
```

--------------------------------

### GET /api/v1/notes/{note}

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Get information about a specific fragrance note. The note is provided as a path parameter.

```APIDOC
## GET /api/v1/notes/{note}

### Description
Get information about a specific fragrance note. The note is provided as a path parameter.

### Method
GET

### Endpoint
/api/v1/notes/{note}

### Parameters
#### Path Parameters
- **note** (string) - Required - The name of the note (e.g., 'ambroxan').

### Request Example
```
GET https://mcp.10ml.com/api/v1/notes/ambroxan
```

### Response
#### Success Response (200)
Returns information about the note.

#### Response Example
```json
{
  "name": "string",
  "description": "string"
}
```
```

--------------------------------

### GET /api/v1/alternatives

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Retrieve alternative perfumes for a given perfume. Returns a list of alternative options.

```APIDOC
## GET /api/v1/alternatives

### Description
Retrieve alternative perfumes for a given perfume. Returns a list of alternative options.

### Method
GET

### Endpoint
/api/v1/alternatives

### Parameters
#### Query Parameters
- **perfume** (string) - Required - The name of the perfume to find alternatives for.

### Request Example
```
GET https://mcp.10ml.com/api/v1/alternatives?perfume=Creed+Aventus
```

### Response
#### Success Response (200)
Returns a list of alternative perfumes.

#### Response Example
```json
[
  {
    "id": "string",
    "name": "string",
    "house": "string",
    "notes": ["string"]
  }
]
```
```

--------------------------------

### Add perfume-finder MCP server to cline_mcp_settings.json

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/llms-install.md

Configuration entry to add inside the mcpServers object of the MCP settings file (e.g., cline_mcp_settings.json). Keep any existing servers. The client connects automatically after saving.

```json
"perfume-finder": {
  "type": "streamableHttp",
  "url": "https://mcp.10ml.com/mcp",
  "disabled": false
}
```

--------------------------------

### GET /api/v1/houses/{house}

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Get information about a specific perfume house. The house is provided as a path parameter.

```APIDOC
## GET /api/v1/houses/{house}

### Description
Get information about a specific perfume house. The house is provided as a path parameter.

### Method
GET

### Endpoint
/api/v1/houses/{house}

### Parameters
#### Path Parameters
- **house** (string) - Required - The name of the house (e.g., 'amouage').

### Request Example
```
GET https://mcp.10ml.com/api/v1/houses/amouage
```

### Response
#### Success Response (200)
Returns information about the house.

#### Response Example
```json
{
  "name": "string",
  "description": "string"
}
```
```

--------------------------------

### GET /api/v1/similar

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Find perfumes similar to a given perfume, with an optional steering parameter to adjust the similarity direction. Returns a list of similar perfumes.

```APIDOC
## GET /api/v1/similar

### Description
Find perfumes similar to a given perfume, with an optional steering parameter to adjust the similarity direction. Returns a list of similar perfumes.

### Method
GET

### Endpoint
/api/v1/similar

### Parameters
#### Query Parameters
- **perfume** (string) - Required - The name of the perfume to find similar ones for.
- **steer** (string) - Optional - Steering direction (e.g., 'fresher').

### Request Example
```
GET https://mcp.10ml.com/api/v1/similar?perfume=Baccarat+Rouge+540&steer=fresher
```

### Response
#### Success Response (200)
Returns a list of similar perfumes.

#### Response Example
```json
[
  {
    "id": "string",
    "name": "string",
    "house": "string",
    "notes": ["string"]
  }
]
```
```

--------------------------------

### GET /api/v1/perfumes

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Search for perfumes by query parameters such as fragrance notes and gender. Returns a list of matching perfumes.

```APIDOC
## GET /api/v1/perfumes

### Description
Search for perfumes by query parameters such as fragrance notes and gender. Returns a list of matching perfumes.

### Method
GET

### Endpoint
/api/v1/perfumes

### Parameters
#### Query Parameters
- **q** (string) - Optional - Search query for fragrance notes or description.
- **gender** (string) - Optional - Gender filter (e.g., 'men').

### Request Example
```
GET https://mcp.10ml.com/api/v1/perfumes?q=fresh+citrus+summer&gender=men
```

### Response
#### Success Response (200)
Returns a list of perfumes matching the query.

#### Response Example
```json
[
  {
    "id": "string",
    "name": "string",
    "house": "string",
    "notes": ["string"]
  }
]
```
```

--------------------------------

### REST API endpoints for perfume queries

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Use these HTTP GET requests to access the same answers as the MCP server over plain HTTP. The API is described by an OpenAPI 3.1 file and an llms.txt file.

```text
GET https://mcp.10ml.com/api/v1/perfumes?q=fresh+citrus+summer&gender=men
GET https://mcp.10ml.com/api/v1/perfumes/creed-aventus-edp
GET https://mcp.10ml.com/api/v1/similar?perfume=Baccarat+Rouge+540&steer=fresher
GET https://mcp.10ml.com/api/v1/alternatives?perfume=Creed+Aventus
GET https://mcp.10ml.com/api/v1/notes/ambroxan
GET https://mcp.10ml.com/api/v1/houses/amouage
GET https://mcp.10ml.com/api/v1/guides?q=oud&locale=de
```

--------------------------------

### GET /api/v1/perfumes/{id}

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Retrieve detailed information about a specific perfume by its ID. The ID is typically a slug like 'creed-aventus-edp'.

```APIDOC
## GET /api/v1/perfumes/{id}

### Description
Retrieve detailed information about a specific perfume by its ID. The ID is typically a slug like 'creed-aventus-edp'.

### Method
GET

### Endpoint
/api/v1/perfumes/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The perfume ID (slug).

### Request Example
```
GET https://mcp.10ml.com/api/v1/perfumes/creed-aventus-edp
```

### Response
#### Success Response (200)
Returns detailed information about the perfume.

#### Response Example
```json
{
  "id": "string",
  "name": "string",
  "house": "string",
  "notes": ["string"],
  "description": "string"
}
```
```

--------------------------------

### MCP server configuration for Claude Desktop, Cursor, Windsurf, Cline, and Zed

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Add this JSON to the client's settings to connect to the MCP server via npx. The server runs over stdio using the npm package @10ml/perfume-finder-mcp.

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

--------------------------------

### Add MCP server via Claude Code CLI

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Use this command to register the perfume-finder MCP server with Claude Code over HTTP transport.

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

--------------------------------

### Goose configuration for MCP server

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Add this YAML to ~/.config/goose/config.yaml to enable the perfume-finder extension. It runs the server via npx with a 300-second timeout.

```yaml
extensions:
  perfume-finder:
    name: 10ML Fragrance Index
    type: stdio
    cmd: npx
    args: ["-y", "@10ml/perfume-finder-mcp"]
    enabled: true
    timeout: 300
```

--------------------------------

### VS Code MCP settings for perfume-finder

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Add this JSON to your VS Code MCP settings to connect via HTTP.

```json
{
  "servers": {
    "perfume-finder": { "type": "http", "url": "https://mcp.10ml.com/mcp" }
  }
}
```

--------------------------------

### Cursor MCP settings for perfume-finder

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Add this JSON to your Cursor MCP settings to connect to the perfume-finder server.

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

--------------------------------

### Windsurf MCP settings for perfume-finder

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

Add this JSON to your Windsurf MCP settings to connect to the server.

```json
{
  "mcpServers": {
    "perfume-finder": { "serverUrl": "https://mcp.10ml.com/mcp" }
  }
}
```

--------------------------------

### Remote MCP Endpoint URL

Source: https://github.com/10ml-com/perfume-finder-mcp/blob/main/README.md

The remote endpoint for the 10ML Perfume Finder MCP server. Add this URL as a custom connector in MCP clients like Claude, ChatGPT, Cursor, VS Code, or Gemini CLI. No API key or sign-in required.

```text
https://mcp.10ml.com/mcp
```
Tokens:
Raw