MCPサーバー

Perfume Picks

io.github.bguillow-rgb/perfume-picks
コマース・小売 公開・接続可能 MCP 2026-07-28

このMCPでできること

Searches and compares fragrances, identifies dupes, provides wear and note data, and recommends scents by preferences, budget, and occasion.

compare_fragrances
Side-by-side comparison: note pyramids, shared and distinct accords, longevity/sillage/compliment scores, concentration, and price difference.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fragrance_a', 'fragrance_b'], 'properties': {'fragrance_a': {'type': 'string', 'maxLength': 200, 'description': 'First fragrance â\x80\x94 slug or name'}, 'fragrance_b': {'type': 'string', 'maxLength': 200, 'description': 'Second fragrance â\x80\x94 slug or name'}}, 'additionalProperties': False}
find_dupes
Curated dupes for a fragrance — cheaper scents documented to smell like the original, with match percentage and price comparison. The answer to 'what smells like X without the price tag'.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fragrance'], 'properties': {'fragrance': {'type': 'string', 'maxLength': 200, 'description': 'Fragrance slug or name to find dupes for'}}, 'additionalProperties': False}
find_similar
Fragrances most similar to a given one, from Perfume Picks' precomputed similarity ranking over notes and accords.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fragrance'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'fragrance': {'type': 'string', 'maxLength': 200, 'description': 'Fragrance slug or name'}}, 'additionalProperties': False}
get_fragrance
Detailed record for one fragrance: full note pyramid (top/heart/base), accords, concentration, community longevity/sillage/compliment scores, and MSRP. Accepts a Perfume Picks slug or a name like 'Bleu de Chanel'.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug_or_name'], 'properties': {'slug_or_name': {'type': 'string', 'maxLength': 200, 'description': 'Fragrance slug or name'}}, 'additionalProperties': False}
get_recommendations
Personalized fragrance picks from note/accord preferences (e.g. 'vanilla', 'oud', 'citrus'), a budget in USD, an occasion ('office', 'date night', 'gift', 'signature scent'), and gender presentation.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['preferences'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'budget': {'type': 'number', 'minimum': 0, 'description': 'Max MSRP in USD'}, 'gender': {'enum': ['masculine', 'feminine', 'unisex'], 'type': 'string', 'description': 'Marketed gender category of the fragrance; omit to include all'}, 'occasion': {'type': 'string', 'maxLength': 120, 'description': 'What the fragrance is for'}, 'preferences': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60}, 'maxItems': 20, 'minItems': 1, 'description': "Notes or accords the wearer enjoys, e.g. ['vanilla','amber','rose']"}}, 'additionalProperties': False}
search_fragrances
Full-text search across 13,000+ fragrances in the Perfume Picks database. Filter by brand, fragrance family, gender, and MSRP (USD). Returns note pyramids, accords, and community wear scores with source attribution.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'brand': {'type': 'string', 'maxLength': 200, 'description': "Brand name filter, e.g. 'Dior'"}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 10, max 10)'}, 'query': {'type': 'string', 'maxLength': 120, 'description': 'Free-text search: fragrance or brand name'}, 'gender': {'enum': ['masculine', 'feminine', 'unisex'], 'type': 'string', 'description': 'Marketed gender category of the fragrance; omit to include all'}, 'price_max': {'type': 'number', 'minimum': 0, 'description': 'Maximum MSRP in USD'}, 'price_min': {'type': 'number', 'minimum': 0, 'description': 'Minimum MSRP in USD'}, 'fragrance_family': {'type': 'string', 'maxLength': 120, 'description': "Family filter, e.g. 'woody', 'amber', 'fresh'"}}, 'additionalProperties': False}
trending_fragrances
Fragrances Perfume Picks users are adding to their wardrobes most over the last 30 days (falls back to catalog popularity when live activity data is unavailable). The method used is labeled in the response.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 10, max 10)'}}, 'additionalProperties': False}
what_to_wear_tonight
A fragrance suggestion for right now, based on mood, occasion (e.g. 'date', 'office tomorrow', 'night out', 'cozy evening in'), and season — scored with Perfume Picks' community compliment, office-safety, and versatility data.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mood': {'type': 'string', 'maxLength': 120, 'description': "How you're feeling"}, 'gender': {'enum': ['masculine', 'feminine', 'unisex'], 'type': 'string', 'description': 'Marketed gender category of the fragrance; omit to include all'}, 'season': {'enum': ['winter', 'spring', 'summer', 'fall'], 'type': 'string', 'description': 'Season to weight the pick toward â\x80\x94 heavier, warmer scents in winter; fresher in summer'}, 'occasion': {'type': 'string', 'maxLength': 120, 'description': 'The setting'}}, 'additionalProperties': False}
追加
what_to_wear_tonight
2026年9月17日12:40
追加
trending_fragrances
2026年9月17日12:40
追加
compare_fragrances
2026年9月17日12:40
追加
get_recommendations
2026年9月17日12:40
追加
find_similar
2026年9月17日12:40
追加
find_dupes
2026年9月17日12:40
追加
get_fragrance
2026年9月17日12:40
追加
search_fragrances
2026年9月17日12:40