The Blue Perfumery MCP Server provides seamless access to a collection of 50+ premium fragrances, enabling AI assistants to help users discover and purchase perfumes through comprehensive data management tools.
List all perfumes: Retrieve the complete collection with detailed information
Search perfumes: Perform intelligent searches by name or brand to find specific fragrances
Get perfume by ID: Access detailed information for a specific perfume using its unique identifier
Filter by category: Narrow down results by gender (men's, women's) or niche perfumes
Get purchase links: Obtain direct Shopier purchase links for any perfume
Access comprehensive details: View complete perfume information including name, brand, price, volume, gender, scent notes, description, age range recommendations, and characteristic descriptors
Server is built with Node.js, allowing for deployment and execution of the MCP server in Node.js environments.
Enables distribution and installation of the MCP server as an NPM package with the @blueperfumery/mcp-server package name.
Server is implemented using TypeScript, providing type safety and modern JavaScript features for the MCP implementation.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Blue Perfumery MCP Serverfind me a unisex perfume with vanilla notes under 1500 TL"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Blue Perfumery MCP Server
Model Context Protocol (MCP) server that enables AI assistants like Claude to access Blue Perfumery's perfume database and product information.
What is MCP?
Model Context Protocol is an open standard that allows AI assistants to securely access external data sources and tools. This server provides Claude and other MCP-compatible assistants direct access to Blue Perfumery's product catalog.
Related MCP server: Bluesky MCP Server
Tech Stack
Technology | Version | Purpose |
Node.js | 18+ | Runtime |
TypeScript | 5.3+ | Type Safety |
MCP SDK | 0.5+ | Protocol Implementation |
MongoDB | - | Database |
Mongoose | 8.0+ | ODM |
Available Tools
Tool | Description |
| Get all perfumes in the collection |
| Get a specific perfume by ID |
| Search perfumes by name or brand |
| Filter by category (men, women, niche) |
| Get Shopier purchase link for a perfume |
Installation
Claude Desktop Integration
Add to your Claude Desktop config (claude_desktop_config.json):
Project Structure
Example Usage
Once configured, you can ask Claude:
"What perfumes does Blue Perfumery have?"
"Search for woody perfumes"
"Show me men's fragrances"
"Get the purchase link for [perfume name]"
Environment Variables
Variable | Description |
| MongoDB connection string |
Scripts
Command | Description |
| Development with tsx |
| Compile TypeScript |
| Start server |
License
MIT