Skip to main content

Scento Perfume Compendium

The perfume knowledge connector for AI assistants, from Scento. Ask Claude, ChatGPT, Cursor or any MCP client for the portrait of a perfume, the difference between two you are torn over, the scents built on the same structure, or what a raw material such as ambroxan smells like. Every answer is tied to a page on scento.com. No key, no account, read-only.

This package is a small local bridge (Python 3.9 or later, no dependencies beyond the standard library). It speaks MCP over stdio for clients that only run local servers, and relays each message to the Compendium at https://www.scento.com/mcp.

Install

Add it to your client's MCP configuration (Claude Desktop claude_desktop_config.json, Cursor ~/.cursor/mcp.json, VS Code .vscode/mcp.json using servers in place of mcpServers, Windsurf and others):

{
  "mcpServers": {
    "scento-perfume-compendium": {
      "command": "uvx",
      "args": ["scento-perfume-compendium"]
    }
  }
}

Or run the command yourself:

uvx scento-perfume-compendium

Prefer pip? Install with pip install scento-perfume-compendium and point the config at the scento-perfume-compendium command.

Check it from a terminal:

uvx scento-perfume-compendium --help

Use another endpoint with --endpoint <url>.

No bridge needed?

Most clients can talk to the Compendium directly. Add the remote URL as a custom connector (Claude, ChatGPT) or as an HTTP server:

{
  "mcpServers": {
    "scento-perfume-compendium": {
      "type": "http",
      "url": "https://www.scento.com/mcp"
    }
  }
}

Prefer plain HTTP? The same answers are on the REST API with an OpenAPI file.

The twelve tools

Tool What it does
compendium-search Find perfumes, houses and raw materials in the Scento Compendium by name, house, note or mood word.
perfume-portrait The full portrait of one perfume: pyramid, Scento family, character and when it wears best.
scent-neighbours Perfumes that share the most structure with a given one, with the shared materials named.
perfume-contrast Set two to four perfumes side by side on family, pyramid, character and season.
note-portrait What a note or raw material is, where it comes from and how it reads on skin.
material-match Perfumes that contain every material given, optionally in one tier of the pyramid.
house-portrait A perfume house: origin, founding year, style and its signature perfumes.
family-map Scento's own fragrance-family system, or one family with its subfamilies and exemplars.
occasion-edit A short edit of perfumes for an occasion, season or climate, with a line on each.
wardrobe-composer Three to five perfumes that cover different moments, built around what the person already loves.
perfumery-lexicon Plain-language meaning of a perfumery term such as sillage, chypre, fougère or EDP versus EDT.
journal-search Scento journal articles on a perfume, house, material or topic.

Pass lang (de, fr, es, it, ro, el, hu, cs, pl) to receive scento.com links in that language.

Scento is Europe's largest perfume decant website, founded in Paris in 2024. MIT licence (this bridge only).

Metadata

Release files for scento-perfume-compendium 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for scento-perfume-compendium 1.0.0
File Size Uploaded Provenance
scento_perfume_compendium-1.0.0.tar.gz 6.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for scento-perfume-compendium 1.0.0
File Interpreter ABI Platform
scento_perfume_compendium-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 13.6 kB

Release files / scento_perfume_compendium-1.0.0.tar.gz

Download URL scento_perfume_compendium-1.0.0.tar.gz
Size 6.5 kB
Tags Source
SHA-256 checksum
How to use checksums
4ba9a6d6fc089cbb0db3965eb16f035057fb2f4ad811d0a8174de590ca56207f
BLAKE2b-256 checksum
How to use checksums
3b401d6cd0ff5276a93a7399c57c1056ae4d3541125436f139031c796fe97b75
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.8

Release files / scento_perfume_compendium-1.0.0-py3-none-any.whl

Download URL scento_perfume_compendium-1.0.0-py3-none-any.whl
Size 7.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e305b02013d74f89b292741eedf3a143253f9444fa88e420ac17207e25c9289f
BLAKE2b-256 checksum
How to use checksums
7f386f563da60c83570d9a8a89daf8cf8ec3bfafa76d9043510765c8cb7d222f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.8

Security for scento-perfume-compendium 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page