Olfastory MCP server

The Olfastory MCP server lets an AI assistant (Claude, ChatGPT, Cursor, VS Code and any MCP client) look up the encyclopedia: notes pyramid, olfactory family, perfumer, year, concentration and house of more than 4,000 perfumes, in six languages, each answer linked to its olfastory.com page. Free, no key, no account, read only.

Connect

Add a remote MCP server (Streamable HTTP) with this URL:

https://www.olfastory.com/mcp

Typical JSON configuration:

{
  "mcpServers": {
    "olfastory": {
      "type": "http",
      "url": "https://www.olfastory.com/mcp"
    }
  }
}

Tools

• search_perfumes — find a perfume by name and/or house, with concentration and gender filters
• get_perfume — one perfume record: notes, family, perfumer, year, concentration
• find_perfumes_by_notes — perfumes by notes (1 to 5), with family, concentration and gender filters
• search — natural-language search (search/fetch format)
• fetch — the full record of a search result

REST interface

• https://www.olfastory.com/mcp/v1/search?q=opium&lang=en
• https://www.olfastory.com/mcp/v1/perfume/angel?lang=en
• https://www.olfastory.com/mcp/v1/notes?notes=vanilla,tobacco&gender=men&lang=en

Limits

2 requests per second and 1,500 per day per address. Answers in French, English, Spanish, German, Italian and Portuguese (lang parameter).

Discovery

• /mcp/server-card
• /.well-known/ai-catalog.json
• com.olfastory/perfume-encyclopedia (MCP Registry)

Documentation · Terms of use · Privacy

FR · ES · DE · IT · PT