目录 / fragrance-mcp
fragrance-mcp
# Noteboxd Fragrance MCP. **Fragrance & perfume intelligence for your AI.** Query the [Noteboxd](https://www.noteboxd.com) 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](https://www.noteboxd.com), 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](https://developers.noteboxd.com).
接入信息
- 传输形态
- http
- 鉴权方式
- 鉴权未知
- 端点
https://fragrance-mcp.run.tools
{
"mcpServers": {
"fragrance-mcp": {
"url": "https://fragrance-mcp.run.tools"
}
}
}
能力清单
| 工具 | 说明 |
|---|---|
| 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. |
提交举报 / 纠错
侵权举报经核验成立后,我们会即时下线该条目并删除已存的内容副本。