io.github.parfica/fragrances

Official3 toolsLive

by parfica · JavaScript

Fragrance encyclopedia: note pyramids, accords, perfumers and dupes (parfica.com).

io.github.parfica/fragrances — Model Context Protocol (MCP) Server

This MCP server provides a fragrance encyclopedia focused on note pyramids, accords, perfumers, and “dupes” (note-overlap similarities). It answers queries like identifying the smell profile of a specific fragrance and finding cheaper alternatives similar to another.

🛠️ Key Features

Note pyramids
Accords
Perfumer information
Community ratings
Note-overlap dupes (similar fragrances)
Integrates as a thin stdio bridge to a native MCP endpoint

🚀 Use Cases

“What does Creed Aventus smell like?”
“Find me cheaper fragrances similar to Baccarat Rouge 540”

⚡ Developer Benefits

Tools are discovered at startup
Bridges to https://parfica.com/mcp via stdio so tooling stays current

⚠️ Limitations

Tool list details are not provided in the available excerpt (toolCount: 3)

Captured live from the server via tools/list.

search_fragrance

Search the parfica.com fragrance encyclopedia by name (Latin or Cyrillic), brand, note or perfumer. Returns matching fragrances, brands, notes and perfumers with links.

Parameters1

query

string

required

Search query, e.g. "Aventus" or "Авентус"

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query, e.g. \"Aventus\" or \"Авентус\""
    }
  },
  "required": [
    "query"
  ]
}

fragrance_info

Full profile of a fragrance on parfica.com by its slug: brand, year, gender, concentration, family, note pyramid, accords, perfumers, community rating.

Parameters1

slug

string

required

Fragrance slug from search_fragrance, e.g. "creed-aventus"

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Fragrance slug from search_fragrance, e.g. \"creed-aventus\""
    }
  },
  "required": [
    "slug"
  ]
}

find_dupes

Find fragrances that smell similar ("dupes") to a given one, by distinctive-note overlap. Returns matches with similarity ranking.

Parameters1

slug

string

required

Fragrance slug, e.g. "maison-francis-kurkdjian-baccarat-rouge-540"

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Fragrance slug, e.g. \"maison-francis-kurkdjian-baccarat-rouge-540\""
    }
  },
  "required": [
    "slug"
  ]
}

README.md2 KBView on GitHub

mcp-server-parfica

MCP (Model Context Protocol) server for parfica.com — the Ukrainian-first fragrance encyclopedia. Ask your AI assistant "what does Creed Aventus smell like?" or "find me cheaper fragrances similar to Baccarat Rouge 540" and it will answer with note pyramids, accords, perfumers, community ratings and note-overlap dupes.

This package is a thin stdio bridge to the site's native MCP endpoint (https://parfica.com/mcp). Tools are discovered at startup, so the package never goes stale.

Tools

Tool	Description
`search_fragrance`	Search fragrances, brands, notes and perfumers by name (Latin or Cyrillic)
`fragrance_info`	Full profile: brand, year, note pyramid, accords, perfumers, community rating
`find_dupes`	"Smells like" matches by distinctive-note overlap

Install

Claude Code

bash

claude mcp add parfica -- npx -y mcp-server-parfica

Claude Desktop

json

{
  "mcpServers": {
    "parfica": {
      "command": "npx",
      "args": ["-y", "mcp-server-parfica"]
    }
  }
}

Remote (no install)

MCP clients that support remote servers can connect straight to:

code

https://parfica.com/mcp

Configuration

Env var	Meaning
`PARFICA_MCP_URL`	Override the endpoint URL (default `https://parfica.com/mcp`)
`PARFICA_TOKEN`	Optional bearer token for future write tools

parfica.com — the encyclopedia itself
fragrance-dupes — the open "smells like" matching algorithm
parfica-open-data — open fragrance data (notes, taxonomy, OBF)

License

Install

Tools (3)

search_fragrancefragrance_infofind_dupes

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "fragrances": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-parfica@1.0.2"
      ]
    }
  }
}

io.github.parfica/fragrances — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_fragrance

fragrance_info

find_dupes

mcp-server-parfica

Tools

Install

Claude Code

Claude Desktop

Remote (no install)

Configuration

Related

License

Install

Related servers