fragrance-mcp

Name: fragrance-mcp
Author: noteboxd

Noteboxd Fragrance MCP.

От сообществаРаботаетБез входаГлобальныйБесплатноМожет изменять данные

Что умеет

Fragrance Search: Search and filter the Noteboxd fragrance encyclopedia. Requires a query or at least one filter — the full catalogue cannot be listed. Tip: The `q` parameter searches fragrance names
Fragrance Get: Get the full profile for a single fragrance by UUID or slug (e.g. 'tom-ford/oud-wood'). Returns notes pyramid, accords, FOTW classification, perfumer, community score, and more. See als
Fragrance Get Reviews: Get paginated community reviews for a fragrance. Sort by helpfulness, recency, or score. See also: `fragrance_get` for the fragrance's full profile · `fragrance_get_wearing_stat

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Noteboxd Fragrance MCP.

Fragrance & perfume intelligence for your AI. Query the Noteboxd fragrance encyclopedia in natural language: search fragrances, notes, accords, brands, and perfumers; read community reviews and charts; get AI comparisons and recommendations; and, once signed in, work with your own cabinet, wishlist, and taste profile.

Try asking

"Find woody fragrances rated above 8/10 from the 2010s"
"Compare Bleu de Chanel and Dior Sauvage"
"What's similar to Oud Wood but more affordable?"
"Who created Santal 33, and what else have they made?"
"Pick something from my cabinet for a hot, humid day" (Pro)

Tools

Search & discovery: search, fragrance_search, trending, fragrance_similar, charts_list, chart_get, notes_list

Fragrances: fragrance_get, fragrance_get_reviews, fragrance_get_wearing_stats, fragrance_compare, fragrance_review_digest

Brands, perfumers & notes: brand_get, perfumer_get, note_explore

AI (Pro): ai_recommend, ai_wear_today, ai_collection

Your data (Pro, after sign-in): user_get_cabinet, user_get_wishlist, user_get_collections, user_get_reviews, user_get_wearing_history, plus taste profile and compatibility (user_taste_public, user_taste_summary, user_taste_compare)

Getting started

Connect and sign in with your Noteboxd account (OAuth). A free account covers the full encyclopedia and discovery tools; Noteboxd Pro unlocks AI recommendations and your personal cabinet, wishlist, and taste tools. You can also authenticate with an API key (Authorization: Bearer nb_live_...) from your Noteboxd settings.

About

Powered by Noteboxd, a fragrance encyclopedia and community. Developers can build on the same data via the REST API and the open-source MCP client at developers.noteboxd.com.

Список инструментов сервера (26)

Технические названия из tools/list. Нужны только разработчикам.

fragrance_search	Search and filter the Noteboxd fragrance encyclopedia. Requires a query or at least one filter — the full catalogue cannot be listed. Tip: The `q` parameter searches fragrance names OR brand names independently. For best results with a known brand, use the `brand` slug filter instead of including the brand name in `q`. Examples: - "Find woody fragrances above 8/10 from the 2010s" → note='woody' + minScore=8 + decade='2010s' - "Creed fragrances" → brand='creed' - "Bleu de Chanel" → q='Bleu' + brand='chanel' See also: `fragrance_get` for a single fragrance's full profile · `search` for universal cross-entity lookup (brands, notes, perfumers, collections in one call).
fragrance_get	Get the full profile for a single fragrance by UUID or slug (e.g. 'tom-ford/oud-wood'). Returns notes pyramid, accords, FOTW classification, perfumer, community score, and more. See also: `fragrance_similar` for fragrances with similar accord profiles · `fragrance_get_reviews` for community reviews · `fragrance_get_wearing_stats` for when people wear it.
fragrance_get_reviews	Get paginated community reviews for a fragrance. Sort by helpfulness, recency, or score. See also: `fragrance_get` for the fragrance's full profile · `fragrance_get_wearing_stats` for aggregate wearing data.
fragrance_get_wearing_stats	Aggregate wearing statistics for a fragrance — when people wear it, in what seasons, and mood tags. Free tier sees total check-ins only; Pro sees full breakdowns. See also: `fragrance_get` for full profile · `fragrance_similar` for alternatives with similar profiles.
brand_get	Get a brand profile (name, country, founded, description) and its top fragrances. Use the brand slug, e.g. 'maison-francis-kurkdjian'. See also: `fragrance_search` with the `brand` filter to get the full paginated catalogue for this brand · `perfumer_get` if the brand has a known house perfumer.
perfumer_get	Get a perfumer's profile (bio, country, house affiliation) and their top fragrances by community score. See also: `fragrance_search` to find more fragrances by this perfumer · `brand_get` if you want the brand they work for.
note_explore	Get a note's profile (family, description, origin, extraction method) and top fragrances featuring it, sorted by community score. Use the note slug, e.g. 'oud', 'bergamot', 'iris'. See also: `notes_list` to browse all notes by family/popularity · `fragrance_search` with the `note` filter to find fragrances featuring this note.
fragrance_compare	Compare two fragrances head-to-head — shared vs. distinct notes/accords/families, community and critic scores, audience, and an AI-written synthesis (shared character, differences, who each suits). Public, cached 7 days per pair. See also: `fragrance_get` for full profiles · `fragrance_similar` for alternatives.
fragrance_review_digest	Get a concise AI-generated digest summarizing a fragrance's community reviews — key themes, consensus, and standout opinions. Public, cached per fragrance. See also: `fragrance_get_reviews` for individual reviews · `fragrance_get` for full profile.
search	Universal search across all Noteboxd entities — fragrances, brands, notes, perfumers, and collections — in a single call. Best for quick lookups and vague queries. Examples: - "Jacques Polge" → returns the perfumer - "oud" → returns the note, plus top oud fragrances - "Bleu" → returns Bleu de Chanel, Bleu de Dior, etc. See also: `fragrance_search` for advanced fragrance-only filtering (by note, decade, score, concentration) · `trending` for what's popular right now.
trending	What's trending on Noteboxd right now — top search queries, highest-rated fragrances, and most popular notes. No parameters needed. See also: `charts_list` for full ranking leaderboards · `fragrance_search` to explore specific categories.
fragrance_similar	Find fragrances with similar accord profiles to a given fragrance. Returns ranked alternatives based on shared accords and character. See also: `fragrance_get` for the source fragrance's full profile · `fragrance_search` with note/accord filters for manual exploration.
charts_list	List all available Noteboxd chart rankings (e.g. top-rated, trending, top by brand). Returns chart names and summary stats. See also: `chart_get` with a chart slug to see the full leaderboard · `trending` for a quick snapshot of what's hot.
chart_get	Get a specific chart leaderboard by slug (e.g. 'top-rated', 'trending', 'top-rated-brand-chanel'). Returns ranked fragrances with scores and movement. See also: `charts_list` to see all available charts · `fragrance_get` for the full profile of any fragrance on the chart.
notes_list	Browse fragrance notes — filter by family (e.g. 'woody', 'floral', 'citrus') and sort by popularity or name. Returns note names, families, colours, and fragrance counts. See also: `note_explore` for a single note's full profile and top fragrances · `fragrance_search` with the `note` filter to find fragrances featuring a specific note.
ai_recommend	Get personalized fragrance recommendations based on your taste profile. Optional natural-language prompt to guide results (e.g. 'something fresh for summer'). Requires Pro. See also: `ai_wear_today` for what to wear right now · `user_get_cabinet` for your collection.
ai_wear_today	What should I wear today? Picks from your owned cabinet (CURRENT status only) based on optional prompt/weather. Returns nothing if your cabinet is empty. Requires Pro. See also: `ai_recommend` for discovery beyond your cabinet · `user_get_cabinet` for your full collection.
ai_collection	Generate a curated fragrance collection from a natural-language prompt (e.g. 'office-safe designer scents under $100', 'niche oud masterpieces'). Returns 5–25 grounded picks with rationale. Requires Pro. See also: `ai_recommend` for personalized picks · `fragrance_search` for manual filtering.
user_get_cabinet	Get your fragrance cabinet — fragrances you own, have tried, or finished. Requires a Pro account. See also: `fragrance_get` for full details on any fragrance in your cabinet · `fragrance_similar` to find alternatives to your favourites · `user_get_wishlist` for fragrances you want to try.
user_get_wishlist	Get your fragrance wishlist. Requires a Pro account. See also: `fragrance_get` for full details on any wishlist fragrance · `user_get_cabinet` for fragrances you already own.
user_get_collections	Get your collections (fragrance lists). Optionally pass a collectionId to see its items. Requires a Pro account. See also: `fragrance_get` for full details on any fragrance in a collection.
user_get_reviews	Get reviews you've written, or reviews you found helpful. Requires a Pro account. See also: `fragrance_get_reviews` for community reviews on a specific fragrance.
user_get_wearing_history	Get your wearing check-in history over time. Requires a Pro account. See also: `fragrance_get_wearing_stats` for aggregate community wearing data on a specific fragrance.
user_taste_public	Get a user's public taste profile — their top notes, accords, and families derived from their collection and reviews. No LLM call, deterministic. See also: `user_taste_compare` for compatibility between two users.
user_taste_summary	Get your AI-generated taste profile summary — a natural-language description of your fragrance preferences based on your cabinet, reviews, and likes. Requires Pro. See also: `user_taste_public` for the deterministic breakdown · `user_taste_compare` for compatibility.
user_taste_compare	Compare your taste with another user — compatibility score, shared and divergent notes/accords/families, and an optional AI overview. Requires Pro for the overview. See also: `user_taste_public` for a user's top preferences · `user_taste_summary` for your own summary.