# Scento Perfume API docs

> Developer documentation for the free, keyless Scento Perfume API: REST routes described in OpenAPI 3.1 and a remote MCP server for Claude, ChatGPT, Cursor and VS Code. Canonical source: https://www.scento.com/developers

## Docs

- [Overview](https://scento-com.github.io/perfume-api/index.md): 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.
- [Getting started](https://scento-com.github.io/perfume-api/getting-started.md): Call the keyless Scento Perfume API at https://www.scento.com/api/perfume/v1 with curl, fetch or requests, fetch the layton portrait, switch the link language with lang, and call it from a browser.
- [Reading an answer](https://scento-com.github.io/perfume-api/response-format.md): Every Scento Perfume API response has folio, lede, detail, scento_page, further_reading, cite and continuation; this page shows each field, how to page with continuation, the lang values and the 400 invalid_input error.
- [Endpoints](https://scento-com.github.io/perfume-api/endpoints.md): Every route of the Scento Perfume API (search, perfumes, contrast, materials, houses, families, edits, wardrobe, lexicon, journal) with its parameters, a curl request and a trimmed live response.
- [MCP server](https://scento-com.github.io/perfume-api/mcp-server.md): Connect the keyless Scento perfume MCP server at https://www.scento.com/mcp to Claude, ChatGPT developer mode, Cursor, VS Code, Windsurf and Claude Code, with the 12 tools and a curl test.
- [Integrations](https://scento-com.github.io/perfume-api/integrations.md): Use the Scento Perfume API from n8n (n8n-nodes-scento-perfume), stdio MCP clients (npx scento-perfume-api, uvx scento-perfume-api), and listings on RapidAPI, Apify, Hugging Face and GitHub.
- [Limits and terms](https://scento-com.github.io/perfume-api/limits-and-terms.md): Scento Perfume API usage in short: no key or published quota, cache answers, no overloading or wholesale copying, credit with the cite line and scento_page link, answers as is, plus the full terms link.

## Source

- [Scento Perfume API on scento.com](https://www.scento.com/developers): the canonical developer page
- [OpenAPI 3.1 spec](https://www.scento.com/api/perfume/v1/openapi.json): the live machine-readable description
- [MCP endpoint](https://www.scento.com/mcp): streamable HTTP, no key
- [Scento](https://www.scento.com/): homepage