# perfumes_by_note

List the perfumes in the 10ML Fragrance Index built around a note (vanilla, oud, bergamot, tonka bean, rose, iris, leather, sandalwood...), most prominent first, optionally only where the note sits in the top, heart or base, or for an audience, season or occasion. Spelling variants and other languages work (agarwood finds oud, Vanille finds vanilla). Use for 'perfumes with oud', 'a vanilla scent for winter' or 'bergamot-forward colognes for men'. Not for explaining what a note smells like (use explain_note) and not for several notes at once (use search_perfumes with notes_include).

Agent View of the PolicyLayer registry record for `perfumes_by_note`. HTML page: https://policylayer.com/tools/10ml-perfume-finder-mcp/perfumes-by-note

## Facts

- Tool: `perfumes_by_note`
- Server: Perfume Finder (`@10ml/perfume-finder-mcp`) — https://policylayer.com/tools/10ml-perfume-finder-mcp.md
- Install: `npx -y @10ml/perfume-finder-mcp`
- Homepage: https://www.npmjs.com/package/@10ml/perfume-finder-mcp
- Risk category: Read (Low risk)
- Registry record: grade B, identity unverified
- Server rate-limited: no
- Parameters: 9 (1 required)
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `note` | string | yes | The note. Examples: "oud", "vanilla", "pink pepper", "Vanille" |
| `limit` | integer | no | How many results per page (1-20, default 8). |
| `cursor` | string | no | next_cursor from the previous page; omit for the first page. |
| `gender` | string | no | Audience the perfume is marketed to. men and women also include unisex perfumes. |
| `locale` | string | no | Language of the 10ml.com links and labels. Perfume, house and note names stay as they are. |
| `season` | string | no | Season the perfume suits (fall is accepted in text queries as autumn). |
| `occasion` | string | no | Occasion the perfume suits: daytime, office, casual, evening, date night or special occasion. |
| `position` | string | no | Where the note sits in the pyramid: top, heart, base or any |
| `response_format` | string | no | concise (default) or detailed (adds note pyramid, seasons, occasions, longevity, projection). |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "perfumes_by_note",
    "arguments": {
      "note": "<note>"
    }
  }
}
```

## Why perfumes_by_note is rated Low

Even though perfumes_by_note only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.

## Use case

AI agents call perfumes_by_note to retrieve information from Perfume Finder without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Perfume Finder:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "perfumes_by_note": {}
  }
}
```

## Other tools on Perfume Finder (14)

- `compare_perfumes` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/compare-perfumes.md
- `explain_note` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/explain-note.md
- `explain_perfume_term` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/explain-perfume-term.md
- `find_gift` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/find-gift.md
- `find_perfume_alternatives` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/find-perfume-alternatives.md
- `find_similar_perfumes` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/find-similar-perfumes.md
- `get_house` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/get-house.md
- `get_perfume` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/get-perfume.md
- `list_houses` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/list-houses.md
- `pick_for_occasion` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/pick-for-occasion.md
- `recommend_perfumes` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/recommend-perfumes.md
- `search_guides` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/search-guides.md
- `search_perfumes` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/search-perfumes.md
- `suggest_layering` — Read — https://policylayer.com/tools/10ml-perfume-finder-mcp/suggest-layering.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=10ml-perfume-finder-mcp · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/10ml-perfume-finder-mcp
