# Scento Perfume API docs: REST routes, MCP server, code examples

> Developer docs for the free Scento Perfume API, with 14 REST routes (perfumes, materials, houses, families, occasions, wardrobe, lexicon, journal), a 12-tool MCP server and curl, JavaScript and Python examples.

Source of truth: https://www.scento.com/developers


The Scento Perfume API is a free, read-only API about perfumes. Ask it for a perfume and you get its top, heart and base notes, its scent family and when it is worn. Ask it for a note and you get what the material smells like and which perfumes show it. It also finds similar perfumes, compares up to four side by side, profiles perfume houses, suggests perfumes for an occasion and searches the Scento journal.

It needs no API key and no account. Every answer links to the matching page on [scento.com](https://www.scento.com/), and the same answers are available over plain HTTP and as a remote [MCP server](mcp-server.md) for AI assistants.

These pages are a developer guide written around the official reference at [www.scento.com/developers](https://www.scento.com/developers), which stays the canonical source.

## Where to start

- [Getting started](getting-started.md): the base URL and a first request in curl, JavaScript and Python.
- [Reading an answer](response-format.md): the shape every response shares, languages, paging and errors.
- [Endpoints](endpoints.md): every route with its parameters, a request and a live response.
- [MCP server](mcp-server.md): connect Claude, ChatGPT, Cursor, VS Code and Claude Code to one URL.
- [Integrations](integrations.md): the n8n node, the stdio packages and the other places the API is listed.
- [Limits and terms](limits-and-terms.md): what is allowed, what is asked of you and how to credit an answer.

## At a glance

| Item | Value |
|---|---|
| REST base URL | `https://www.scento.com/api/perfume/v1` |
| MCP endpoint | `https://www.scento.com/mcp` (streamable HTTP) |
| OpenAPI 3.1 | [openapi.json](https://www.scento.com/api/perfume/v1/openapi.json) |
| Authentication | None |
| Method and format | `GET`, JSON |
| Browser calls | Open CORS |
| Languages | Answers in English; `lang` switches the language of scento.com links |
| Scope | Perfumes, raw materials, houses, families, occasions, journal. No prices, stock or reviews |

Questions or problems: [www.scento.com/developers](https://www.scento.com/developers) lists the contact address.