Fragrances

io.github.parficaPublished by GitHub account parficav1.0.2Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Fragrance encyclopedia server for parfica.com that lets an assistant search perfumes, read full profiles, and find similar-smelling "dupes".

What you can do
  • Search fragrances, brands, notes and perfumers by name in Latin or Cyrillic, with links to results
  • Read a fragrance's full profile by slug: brand, year, gender, concentration, family, note pyramid, accords, perfumers and community rating
  • Find "dupes" — fragrances that smell similar to a given one, ranked by distinctive-note overlap
When to use it
Useful when someone asks what a perfume smells like, wants notes or accords for a specific fragrance, or asks for cheaper or similar alternatives to a known scent. It is a read-only reference lookup, not a shopping or price tool.
Requirements
Either a remote MCP client pointed at the parfica.com MCP endpoint, or Node.js with npx to run the mcp-server-parfica package locally. No account or API key is required; an optional PARFICA_MCP_URL variable overrides the endpoint and an optional PARFICA_TOKEN bearer token is accepted. Network access to parfica.com is needed.
Before you install
The local package is a thin bridge that forwards requests to the parfica.com endpoint, so queries and lookups go to that third party. An optional PARFICA_TOKEN bearer token can be configured; it is described as reserved for future write tools, so treat it as a secret. All current tools only read data.

Installation

In SourceWeft

  1. Open Fragrances in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.parfica%2Ffragrances/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "fragrances": {
      "type": "http",
      "url": "https://parfica.com/mcp"
    }
  }
}

README

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

ToolDescription
search_fragranceSearch fragrances, brands, notes and perfumers by name (Latin or Cyrillic)
fragrance_infoFull 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:

https://parfica.com/mcp

Configuration

Env varMeaning
PARFICA_MCP_URLOverride the endpoint URL (default https://parfica.com/mcp)
PARFICA_TOKENOptional bearer token for future write tools

Related

License

MIT © parfica.com

Source: README.md at commit 0de80be

Tools

3

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.

Parametersqueryrequired

fragrance_info

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

Parametersslugrequired

find_dupes

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

Parametersslugrequired

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts