# Scento Perfume API (MCP server)

Lets your assistant look up notes, families and similar scents across 1,400+ perfumes. No key, no account, read-only.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: Scento-com
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Scento-com/perfume-mcp-server
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/scento-perfume-api-mcp-server

## What it does

The server answers fragrance questions inside your chat: which notes sit in a perfume, what family it belongs to, how two scents differ in structure. Search works by name, house, note or a mood word, and every answer links back to a page on scento.com. Twelve tools ship with it, from a single-perfume portrait to a wardrobe built from three to five bottles.

Connection is remote over streamable HTTP at `https://www.scento.com/mcp`, with no authentication. Clients that only launch local servers go through the stdio bridge: `npx -y scento-perfume-api` on Node 18+ or `uvx scento-perfume-api` on Python 3.9+. Pick the bridge and you need that runtime installed — without it the server never starts.

Tools take a `lang` parameter for German, French, Spanish, Italian, Romanian, Greek, Hungarian, Czech or Polish, which returns scento.com links in that language. There is no Russian among them, so links come back in one of the listed languages while answers follow your prompt. The same data is also exposed as a plain REST API.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://www.scento.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http perfume-api https://www.scento.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add scento-perfume-api-mcp-server -- npx -y scento-perfume-api
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add scento-perfume-api-mcp-server --url https://www.scento.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add scento-perfume-api-mcp-server -- npx -y scento-perfume-api
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "scento-perfume-api-mcp-server": {
            "url": "https://www.scento.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "scento-perfume-api-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "scento-perfume-api"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "scento-perfume-api-mcp-server": {
            "type": "http",
            "url": "https://www.scento.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "scento-perfume-api-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "scento-perfume-api"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http scento-perfume-api-mcp-server https://www.scento.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add scento-perfume-api-mcp-server npx -y scento-perfume-api
```

## When to use it
- look up the notes and family of a specific perfume
- compare two to four scents by pyramid and character
- find similar perfumes that share materials
- pick a fragrance for a season or occasion
- explain a term like sillage or EDP versus EDT

## Example prompts
- What notes are in this perfume and which family is it?
- Find perfumes that contain ambroxan and vanilla
- Build a wardrobe of three scents for different moments

## Similar
- [10ML Perfume Finder](https://affpapa.org/en/nevibecode/mcp/10ml-perfume-finder.md) — MCP server
- [reddit-search-api](https://affpapa.org/en/nevibecode/skills/reddit-search-api.md) — skill · 10600 installs
- [api-pagination](https://affpapa.org/en/nevibecode/skills/api-pagination.md) — skill · 489 installs
- [solanatracker-api](https://affpapa.org/en/nevibecode/skills/solanatracker-api.md) — skill · 434 installs
- [mcp-brasil-api](https://affpapa.org/en/nevibecode/mcp/mcp-brasil-api.md) — MCP server · ★ 274
- [India API](https://affpapa.org/en/nevibecode/mcp/india-api.md) — MCP server · ★ 9

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md