MCP-Server

Perfume Picks

io.github.bguillow-rgb/perfume-picks
Commerce & Retail Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

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.
Nur Lesen Idempotent
Eingabeschema
{'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'.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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'.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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}
Hinzugefügt
what_to_wear_tonight
17. September 2026 12:40
Hinzugefügt
trending_fragrances
17. September 2026 12:40
Hinzugefügt
compare_fragrances
17. September 2026 12:40
Hinzugefügt
get_recommendations
17. September 2026 12:40
Hinzugefügt
find_similar
17. September 2026 12:40
Hinzugefügt
find_dupes
17. September 2026 12:40
Hinzugefügt
get_fragrance
17. September 2026 12:40
Hinzugefügt
search_fragrances
17. September 2026 12:40