parfum1 Perfume API

Working Security A

com.parfum1/perfumesv1.0.0 Domain verified

parfum1 perfume catalogue: notes, 3/10/30 ml sizes, EUR prices, stock, houses, delivery, returns.

Commerce

Watch Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-07T02:11:08.54485Z",
      "publishedAt": "2026-11-07T02:11:08.54485Z",
      "statusChangedAt": "2026-11-07T02:11:08.54485Z"
    }
  },
  "server": {
    "name": "com.parfum1/perfumes",
    "icons": [
      {
        "src": "https://parfum1.com/apple-touch-icon.png",
        "mimeType": "image/png"
      }
    ],
    "title": "parfum1 Perfume API",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://parfum1.com/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "1.0.0",
    "websiteUrl": "https://parfum1.com",
    "description": "parfum1 perfume catalogue: notes, 3/10/30 ml sizes, EUR prices, stock, houses, delivery, returns."
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://parfum1.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_house Read-only

Read one perfume house by its handle: its introduction, the number of perfumes and the first 50 of them with starting price and stock. Use search_perfumes with the house for the rest.

handlestring, required

The house handle from list_houses, for example "nishane".

Tools (5)

get_house

Read one perfume house by its handle: its introduction, the number of perfumes and the first 50 of them with starting price and stock. Use search_perfumes with the house for the rest.

read-only

Argument	Type	Description
handle*	string	The house handle from list_houses, for example "nishane".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "handle"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]*$",
      "maxLength": 200,
      "description": "The house handle from list_houses, for example \"nishane\"."
    }
  },
  "additionalProperties": false
}

get_perfume

Read one perfume by its handle: name, house, description, top, heart and base notes, and every size (3, 10 and 30 ml) with the price, the struck regular price, price per ml and whether it is in stock, exactly as the product page shows them, plus the full bottle (listed out of stock) and the product URL.

read-only

Argument	Type	Description
handle*	string	The perfume handle from search_perfumes, for example "hacivat-by-nishane".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "handle"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]*$",
      "maxLength": 200,
      "description": "The perfume handle from search_perfumes, for example \"hacivat-by-nishane\"."
    }
  },
  "additionalProperties": false
}

get_store_info

Read how parfum1 works, with the same facts as its help pages: delivery (dispatch, cost, countries), returns, payment methods and contact details. Pass a topic for one, or none for all four.

read-only

Argument	Type	Description
topic	string	One of delivery, returns, payment, contact. Leave empty for all four.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "topic": {
      "enum": [
        "delivery",
        "returns",
        "payment",
        "contact"
      ],
      "type": "string",
      "description": "One of delivery, returns, payment, contact. Leave empty for all four."
    }
  },
  "additionalProperties": false
}

list_houses

List the perfume houses in the catalogue, A to Z, with their handle, whether the house is a niche house, the number of perfumes and the house page URL. Optionally filter by words in the house name.

read-only

Argument	Type	Description
query	string	Words in the house name, for example "dior".

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "Words in the house name, for example \"dior\"."
    }
  },
  "additionalProperties": false
}

search_perfumes

Search the parfum1 catalogue by words in the perfume name, house or scent family (all words must match, accents ignored), optionally within one house. Returns a page of perfumes in popularity order with the starting price, stock, rating and product URL.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1.
house	string	Only perfumes of this house: a house handle or name from list_houses, for example "nishane".
query	string	Words to find in the perfume name, house or scent family, for example "oud" or "nishane hacivat". Leave empty to list the catalogue.
per_page	integer	Perfumes per page, 1 to 50.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number, starting at 1."
    },
    "house": {
      "type": "string",
      "maxLength": 100,
      "description": "Only perfumes of this house: a house handle or name from list_houses, for example \"nishane\"."
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "Words to find in the perfume name, house or scent family, for example \"oud\" or \"nishane hacivat\". Leave empty to list the catalogue."
    },
    "per_page": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Perfumes per page, 1 to 50."
    }
  },
  "additionalProperties": false
}

parfum1 Perfume API

Registry entry

Try it

get_house Read-only

parfum1 Perfume API

Registry entry

Try it

get_house Read-only

Install

Tools (5)

Security checkA100/100