io.github.parfica/fragrances
Fragrance encyclopedia: note pyramids, accords, perfumers and dupes (parfica.com).
Open source Repository Open in the app JSON README (API)
About
Fragrance encyclopedia: note pyramids, accords, perfumers and dupes (parfica.com).
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- parfica
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.2
- Last push
- 2026-08-05T17:44:40Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:00:59
- Updated
- 2026-08-29 04:00:59
- Origin id
io.github.parfica/fragrances
README
# mcp-server-parfica
MCP (Model Context Protocol) server for **[parfica.com](https://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:
```
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 |
## Related
- [parfica.com](https://parfica.com) — the encyclopedia itself
- [`fragrance-dupes`](https://github.com/parfica/fragrance-dupes) — the open "smells like" matching algorithm
- [`parfica-open-data`](https://github.com/parfica/parfica-open-data) — open fragrance data (notes, taxonomy, OBF)
## License
MIT © [parfica.com](https://parfica.com)