# Olfastory

> Olfastory is a free MCP server for fragrance. Look up notes, family, perfumer and year for 4,000+ perfumes in six languages. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://www.olfastory.com/mcp/docs
- **MCP Registry name:** com.olfastory/perfume-encyclopedia
- **Categories:** fragrance
- **Listing updated:** 2026-11-15

## About

Each answer links back to the perfume's page on olfastory.com. You can search by name or house with concentration and gender filters, open a single perfume's sheet, or work backwards from one to five notes to find fragrances that contain them, with family, concentration and gender filters.

Responses can be returned in French, English, Spanish, German, Italian or Portuguese using a lang parameter. A plain REST interface mirrors the tools, for example search and perfume endpoints, and the site publishes a server card and an ai-catalog file for discovery.

The server is free, read-only and needs no key or account. Limits are 2 requests per second and 1,500 per day per address. The documentation page is in French.

## Features

- **Perfume search:** Finds perfumes by name or house with concentration and gender filters.
- **Perfume sheets:** Returns notes, family, perfumer, year and concentration.
- **Search by notes:** Finds perfumes from one to five notes.
- **Six languages:** Answers in French, English, Spanish, German, Italian or Portuguese.
- **REST interface:** Offers the same data over plain GET endpoints.

## Good for

- Find fragrances containing vanilla and tobacco
- Check who composed a perfume and when
- Compare notes across a house's range
- Answer scent questions with linked sources

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http perfume-encyclopedia https://www.olfastory.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.olfastory.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "perfume-encyclopedia": {
      "url": "https://www.olfastory.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "perfume-encyclopedia": {
      "type": "http",
      "url": "https://www.olfastory.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "perfume-encyclopedia": {
      "serverUrl": "https://www.olfastory.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "perfume-encyclopedia": {
      "type": "http",
      "url": "https://www.olfastory.com/mcp"
    }
  }
}
```

## Tools

- `search_perfumes`: Find a perfume, fragrance or cologne in the Olfastory encyclopedia by name and/or house (for example "Opium Yves Saint Laurent", "Hawas Ice"); small spelling mistakes are corrected (corrected_query). Optional filters: concentration ("Eau de Parfum", "EDT", "Extrait") and gender (women, men, unisex, children). Returns at most 10 matches, most consulted first, each with house, year, concentration an
- `get_perfume`: Use when the user asks about one perfume: its notes pyramid (top, heart, base), olfactory family, perfumer, year, concentration or house. Accepts an olfastory.com URL (best), a slug, or "name house". If several perfumes match (flankers, concentrations), the result lists the candidates with ambiguous=true: pick one and call again with its URL. Returns facts only; an empty field means the fact is no
- `find_perfumes_by_notes`: Use when the user wants perfumes that contain given notes or raw materials (1 to 5, for example vanilla and tobacco), optionally in the top, heart or base. Note names are accepted in French, English, Spanish, German, Italian or Portuguese. Optional filters: olfactory family (primary or secondary, for example "woody"), concentration and gender (women, men, unisex, children). Returns at most 10 perf
- `search`: Search the Olfastory perfume encyclopedia with a natural-language query: a perfume or house name ("Angel Mugler") or notes ("vanilla tobacco"). Returns up to 10 results, each with an id, a title and its olfastory.com URL. Pass an id to fetch for the full record. Cite Olfastory with the URL.
- `fetch`: Fetch the full Olfastory record of a perfume by an id returned by search (or an olfastory.com URL): house, year, concentration, perfumers, olfactory family, notes pyramid and a one-sentence presentation, with its URL. Cite Olfastory with the URL.

## FAQ

### Do I need a key?

No. It is free with no key or account.

### What are the rate limits?

2 requests per second and 1,500 per day per address.

### Which languages are supported?

French, English, Spanish, German, Italian and Portuguese.

### Can it write data?

No, it is read-only.

### Is Olfastory free?

Yes. Olfastory is free to use.

### How do I add Olfastory to Claude Code?

Run this command in your terminal: claude mcp add --transport http perfume-encyclopedia https://www.olfastory.com/mcp

---
Source: https://ai-powered.com/mcp/olfastory
