# Scento Perfume API (MCP server)

> Scento Perfume API (MCP server) is a free MCP server for e-commerce. Perfume notes, scent families and similar-scent lookups, free with no API key. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web, CLI
- **Website:** https://www.scento.com/developers
- **Repository:** https://github.com/scento-com/perfume-mcp-server
- **MCP Registry name:** com.scento/perfume-api
- **Categories:** e-commerce, knowledge and memory
- **Listing updated:** 2026-11-14

## About

Scento says each answer is tied to a page on scento.com and that every note pyramid is traced to the house or an authorised retailer, so notes are not scraped guesses. The data spans 1,600+ designer and niche perfumes, 400+ raw materials and Scento's own family system, with links in ten languages.

The twelve read-only tools are perfume-search, perfume-portrait, scent-neighbours, perfume-contrast, note-portrait, material-match, house-portrait, family-map, occasion-edit, wardrobe-composer, perfumery-lexicon and journal-search. They cover searching by name or mood, a perfume's top, heart and base notes, similar scents, side-by-side comparison, and which perfumes use a raw material.

Besides the remote server at scento.com/mcp, npm and PyPI packages run it over stdio, and a REST version has an OpenAPI spec.

## Features

- **Note pyramids:** Top, heart and base notes with family and perfumer.
- **Similar scents:** Finds perfumes close to one you name.
- **Raw-material matching:** Shows perfumes built on a given ingredient.
- **Occasion edits:** Suggests scents by occasion and builds a wardrobe.
- **REST and MCP:** Same data over an OpenAPI REST API.

## Good for

- Ask what a fragrance smells like
- Find a cheaper alternative with similar notes
- Compare two perfumes
- Plan a small fragrance wardrobe

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http perfume-api https://www.scento.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.scento.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "perfume-api": {
      "url": "https://www.scento.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "perfume-api": {
      "type": "http",
      "url": "https://www.scento.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "perfume-api": {
      "serverUrl": "https://www.scento.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "perfume-api": {
      "type": "http",
      "url": "https://www.scento.com/mcp"
    }
  }
}
```

## Tools

- `perfume-search`: Finds perfumes, houses and notes by name or mood.
- `perfume-portrait`: A perfume's note pyramid, family and profile.
- `scent-neighbours`: Similar scents.
- `perfume-contrast`: Compares perfumes.
- `note-portrait`: Profile of a fragrance note.
- `material-match`: Perfumes that use a raw material.
- `house-portrait`: Profile of a perfume house.
- `family-map`: Maps a scent family.
- `occasion-edit`: Scents by occasion.
- `wardrobe-composer`: Builds a fragrance wardrobe.
- `perfumery-lexicon`: Perfumery terms.
- `journal-search`: Searches Scento's articles.

## FAQ

### Is a key required?

No key and no account.

### How many tools?

Twelve, all read-only.

### Which languages are linked?

Ten, per the site.

### How can I connect?

Remote at https://www.scento.com/mcp, or the scento-perfume-api package on npm or PyPI.

### Is Scento Perfume API (MCP server) free?

Yes. Scento Perfume API (MCP server) is free to use.

### How do I add Scento Perfume API (MCP server) to Claude Code?

Run this command in your terminal: claude mcp add --transport http perfume-api https://www.scento.com/mcp

### What are the best alternatives to Scento Perfume API (MCP server)?

The closest alternatives to Scento Perfume API (MCP server) are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and O'So MCP Server for PrestaShop.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/scento-perfume-api-mcp-server
