Servidor MCP

Perfume Picks

io.github.bguillow-rgb/perfume-picks
Comercio y retail Público y accesible MCP 2026-07-28

Qué hace este 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.
Solo lectura Idempotente
Esquema de entrada
{'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'.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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'.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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}
Añadido
what_to_wear_tonight
17 de September de 2026 a las 12:40
Añadido
trending_fragrances
17 de September de 2026 a las 12:40
Añadido
compare_fragrances
17 de September de 2026 a las 12:40
Añadido
get_recommendations
17 de September de 2026 a las 12:40
Añadido
find_similar
17 de September de 2026 a las 12:40
Añadido
find_dupes
17 de September de 2026 a las 12:40
Añadido
get_fragrance
17 de September de 2026 a las 12:40
Añadido
search_fragrances
17 de September de 2026 a las 12:40