Servers Playground How we check Add a server Log in

PerfuMate

Working · 1.6 s

app.perfumate/perfumatev1.1.0 Domain verified

Perfumery materials, IFRA Category 4, EU allergens, and your formulas and shelf via OAuth.

Design & Creative

Website Registry entry

Maintain this server? Claim it

Try it

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

https://perfumate.app/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.

add_to_shelf

Use this when the user says they have bought or own materials and wants them on their shelf. Adds catalog materials by name or CAS, or their own new ones; each item can carry the bottle strength, solvent, stock in grams, price per gram, supplier and lot. Without a strength, a catalog material gets its usual working dilution (in DPG unless a solvent is given), else neat. A list can also come as pasted text or an attached file: one material per line, or a table whose header row names the columns. Names that match nothing come back with suggestions.

fileobject

A list the user attached in the chat: CSV, TSV, TXT or Excel (.xlsx).

textstring

itemsarray

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

PerfuMate MCP server | mcptry

PerfuMate

Working · 1.6 s

app.perfumate/perfumatev1.1.0 Domain verified

Perfumery materials, IFRA Category 4, EU allergens, and your formulas and shelf via OAuth.

Design & Creative

Website Registry entry

Maintain this server? Claim it

Try it

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

https://perfumate.app/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.

add_to_shelf

fileobject

A list the user attached in the chat: CSV, TSV, TXT or Excel (.xlsx).

textstring

itemsarray

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (45)

add_to_shelf

Argument	Type	Description
file	object	A list the user attached in the chat: CSV, TSV, TXT or Excel (.xlsx).
text	string
items	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "file": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string",
          "format": "uri"
        }
      },
      "description": "A list the user attached in the chat: CSV, TSV, TXT or Excel (.xlsx)."
    },
    "text": {
      "type": "string",
      "maxLength": 100000
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "material"
        ],
        "properties": {
          "cas": {
            "type": "string",
            "maxLength": 40
          },
          "lot": {
            "type": "string",
            "maxLength": 80
          },
          "solvent": {
            "type": "string",
            "maxLength": 40
          },
          "material": {
            "type": "string",
            "maxLength": 160,
            "minLength": 1
          },
          "supplier": {
            "type": "string",
            "maxLength": 80
          },
          "stockGrams": {
            "type": "number",
            "maximum": 1000000,
            "minimum": 0
          },
          "dilutionPct": {
            "type": "number",
            "maximum": 100,
            "exclusiveMinimum": 0
          },
          "newMaterial": {
            "anyOf": [
              {
                "type": "boolean",
                "const": true
              },
              {
                "type": "object",
                "properties": {
                  "cas": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "note": {
                    "enum": [
                      "top",
                      "heart",
                      "base",
                      "none"
                    ],
                    "type": "string"
                  },
                  "odor": {
                    "type": "string",
                    "maxLength": 500
                  },
                  "family": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "natural": {
                    "type": "boolean"
                  }
                }
              }
            ],
            "description": "Only for a material the catalog does not have: create it as the user's own material."
          },
          "pricePerGram": {
            "type": "number",
            "maximum": 1000000,
            "minimum": 0
          },
          "lowStockGrams": {
            "type": "number",
            "maximum": 1000000,
            "minimum": 0
          }
        }
      },
      "maxItems": 300
    }
  }
}

branch_version

Use this when the user wants to start a new line of work from a past version; the old working copy stays in the tree.

Argument	Type	Description
formula*	string	The formula: its id (from list_formulas) or its exact name.
version*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "version"
  ],
  "properties": {
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    },
    "version": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1
    }
  }
}

check_formula

Use this when the user has a perfume or accord formula, pasted or drafted earlier in this conversation, and wants to know whether it is IFRA compliant, how much of the finished product it may be, which line to reduce, or which EU allergens the label must declare. Checks IFRA Category 4 (fine fragrance) at the concentration the user chooses, finds the highest safe concentration and says how far to reduce a line that is over a limit. Give the formula as pasted text (one material per line with an amount) or as structured lines, every line in grams or every line in percent. Lines that match no catalog material are listed and not counted. Does not save anything and does not change the amounts. Returns a link that opens the formula in PerfuMate. For one material's limit use get_material; for a starting recipe use find_starting_formula.

read-only

Argument	Type	Description
lines	array
formula	string	The formula as text, one line per material, e.g. "Hedione 4 g" or "Ambroxan 10% in DPG 2 g".
concentrationPct	number	How much of the finished product the formula is, e.g. 20 for an eau de parfum.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "lines": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "material",
          "amount"
        ],
        "properties": {
          "unit": {
            "enum": [
              "g",
              "mg",
              "kg",
              "%"
            ],
            "type": "string",
            "default": "g"
          },
          "amount": {
            "type": "number",
            "maximum": 100000,
            "exclusiveMinimum": 0
          },
          "material": {
            "type": "string",
            "maxLength": 160,
            "minLength": 1,
            "description": "Material name as written, e.g. \"Iso E Super\"."
          },
          "dilutionPct": {
            "type": "number",
            "maximum": 100,
            "description": "Strength of the bottle used, e.g. 10 for a 10% dilution. Omit for neat.",
            "exclusiveMinimum": 0
          }
        }
      },
      "maxItems": 200
    },
    "formula": {
      "type": "string",
      "maxLength": 20000,
      "description": "The formula as text, one line per material, e.g. \"Hedione 4 g\" or \"Ambroxan 10% in DPG 2 g\"."
    },
    "concentrationPct": {
      "type": "number",
      "default": 20,
      "maximum": 100,
      "minimum": 0.1,
      "description": "How much of the finished product the formula is, e.g. 20 for an eau de parfum."
    }
  }
}

confirm_delete

Use this only after the user has said yes to the list delete_items showed. Deletes exactly that list, with its token. If the list included a protected item, confirmName must be the formula's name as the user typed it. Items stay restorable for 30 days.

destructive

Argument	Type	Description
token*	string
confirmName	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "maxLength": 20000,
      "minLength": 10
    },
    "confirmName": {
      "type": "string",
      "maxLength": 200
    }
  }
}

create_formula

Use this when the user wants a new formula on their PerfuMate bench, empty or with lines they give (structured, pasted text or an attached file), for example after building one together in this chat. Lines are matched to the catalog and the user's own materials; if any line does not match, nothing is saved and the unmatched names come back with suggestions. Bottles the user does not own are added off the shelf, as an import does. To only check a formula without saving it use check_formula.

Argument	Type	Description
file	object	A file the user attached in the chat: CSV, TSV, TXT, JSON or Excel (.xlsx).
kind	string
name	string
text	string	The formula as pasted text, one material per line with an amount.
lines	array
folder	string
batchGrams	number	Batch size when lines are in percent. Default 10 g.
description	string
targetConcentrationPct	number

decompose_accord

Use this when the user wants an accord line replaced by the materials it holds, at the same dose, in place (undo_last_change takes it back).

Argument	Type	Description
line*	string	The line: its material name or line id.
formula*	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "line"
  ],
  "properties": {
    "line": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The line: its material name or line id."
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

delete_items

Use this when the user asks to delete a formula, version, material, bottle, batch or note. It is step 1 of 2 and deletes NOTHING: it shows exactly what would be removed, with any protection, and returns a confirmation token valid for 10 minutes. Show the list to the user; only after they agree, call confirm_delete. Locked formulas cannot be deleted here.

read-only

Argument	Type	Description
items*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "kind",
          "ref"
        ],
        "properties": {
          "ref": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Id or name."
          },
          "kind": {
            "enum": [
              "formula",
              "version",
              "material",
              "bottle",
              "batch",
              "note",
              "journal_note"
            ],
            "type": "string"
          },
          "formula": {
            "type": "string",
            "maxLength": 200,
            "description": "For a version: its formula."
          },
          "material": {
            "type": "string",
            "maxLength": 160
          },
          "dilutionPct": {
            "type": "number",
            "maximum": 100,
            "exclusiveMinimum": 0
          }
        }
      },
      "maxItems": 50,
      "minItems": 1
    }
  }
}

duplicate_formula

Use this when the user wants a copy of a formula to try changes on: an independent copy of its working copy with the same bottles, named "<name> copy" unless named.

Argument	Type	Description
name	string
formula*	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 120
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

edit_formula

Use this when the user wants to change a formula on their bench: add or remove a material, set an amount or a bottle strength, swap a material, flag or note a line, reorder, or scale the whole formula. Changes the working copy in place, as one hand edit in the editor does. No version is made; undo_last_change reverses the change, save_version keeps a version when the user asks. Only when a batch was made from the working copy does the first change start one new working version (the result says so). A formula open in the app updates within seconds. Lines are named by material or id. For add/set_amount always specify unit: g is a weighed amount; % is the final weighed share of the whole formula (including solvent, not the pure aromatic relative/absolute percent). Other weighed lines are held fixed; several % targets are solved together. Never copy relativePct or absolutePct as grams. Read get_formula first and use weighedPct for this kind of percentage edit.

Argument	Type	Description
formula*	string	The formula: its id (from list_formulas) or its exact name.
operations*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "operations"
  ],
  "properties": {
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    },
    "operations": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "op"
        ],
        "properties": {
          "op": {
            "enum": [
              "add",
              "remove",
              "set_amount",
              "set_dilution",
              "swap",
              "set_flag",
              "set_note",
              "reorder",
              "scale"
            ],
            "type": "string"
          },
          "flag": {
            "anyOf": [
              {
                "enum": [
                  "too_strong",
                  "too_weak",
                  "replace"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "line": {
            "type": "string",
            "maxLength": 200,
            "description": "The line: its material name or line id."
          },
          "note": {
            "type": "string",
            "maxLength": 500
          },
          "unit": {
            "enum": [
              "g",
              "%",
              "part",
              "drop"
            ],
            "type": "string",
            "description": "For add/set_amount: g or % for a weighed formula, part/drop only for a line already in that native unit. Legacy omission keeps its native unit, never percent."
          },
          "lines": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 200
            },
            "maxItems": 200,
            "description": "For reorder: lines in their new order."
          },
          "amount": {
            "type": "number",
            "maximum": 100000,
            "minimum": 0,
            "description": "Amount in the explicit unit; never infer grams from a percentage."
          },
          "factor": {
            "type": "number",
            "maximum": 1000,
            "exclusiveMinimum": 0
          },
          "solvent": {
            "type": "string",
            "maxLength": 40
          },
          "material": {
            "type": "string",
            "maxLength": 160
          },
          "totalGrams": {
            "type": "number",
            "maximum": 100000,
            "exclusiveMinimum": 0
          },
          "dilutionPct": {
            "type": "number",
            "maximum": 100,
            "exclusiveMinimum": 0
          },
          "newMaterial": {
            "anyOf": [
              {
                "type": "boolean",
                "const": true
              },
              {
                "type": "object",
                "properties": {
                  "cas": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "note": {
                    "enum": [
                      "top",
                      "heart",
                      "base",
                      "none"
                    ],
                    "type": "string"
                  },
                  "odor": {
                    "type": "string",
                    "maxLength": 500
                  },
                  "family": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "natural": {
                    "type": "boolean"
                  }
                }
              }
            ],
            "description": "Only for a material the catalog does not have: create it as the user's own material."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 100,
      "minItems": 1
    }
  }
}

find_starting_formula

Use this when the user wants to build, create, compose or formulate a perfume, fragrance or accord and needs a starting recipe (a rose, a citrus cologne, a clean musk, an amber), or asks what they could make with materials they list. Matches the idea to PerfuMate's reference accords, the vetted recipes published at perfumate.app/accords, and returns the closest match with its percentages and grams for a batch, already checked against IFRA Category 4 at the concentration given (verdict, highest safe concentration, allergens to declare), plus a link that opens it in PerfuMate and a few alternatives. The ratios are the library's own; nothing is invented, and an idea no accord fits returns the list of available accords instead. Re-check any edited version with check_formula. Not for copying a named commercial perfume. Does not save anything.

read-only

Argument	Type	Description
idea	string	What the user wants to make, in their words, e.g. "fresh citrus cologne", "rose", "clean laundry musk".
batchGrams	number	Batch size in grams for the amounts.
haveMaterials	array	Materials the user already has; accords they can make with them rank first and the missing ones are listed.
concentrationPct	number	How much of the finished product these lines would be, for the IFRA check, e.g. 20 for an eau de parfum.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "idea": {
      "type": "string",
      "maxLength": 200,
      "description": "What the user wants to make, in their words, e.g. \"fresh citrus cologne\", \"rose\", \"clean laundry musk\"."
    },
    "batchGrams": {
      "type": "number",
      "default": 100,
      "maximum": 100000,
      "minimum": 0.1,
      "description": "Batch size in grams for the amounts."
    },
    "haveMaterials": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 160,
        "minLength": 1
      },
      "maxItems": 60,
      "description": "Materials the user already has; accords they can make with them rank first and the missing ones are listed."
    },
    "concentrationPct": {
      "type": "number",
      "default": 20,
      "maximum": 100,
      "minimum": 0.1,
      "description": "How much of the finished product these lines would be, for the IFRA check, e.g. 20 for an eau de parfum."
    }
  }
}

find_substitutes

Use this when the user lacks a material in a formula, or asks what they could use instead from the materials they own: the app's Find on shelf for one line, with single bottles and two- or three-bottle blends from the shelf that can play that material's part, best first, with a match percent and what each carries or misses. Never offers an IFRA-prohibited material. Changes nothing; use_substitute swaps one in.

read-only

Argument	Type	Description
line*	string	The line: its material name or line id.
formula*	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "line"
  ],
  "properties": {
    "line": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The line: its material name or line id."
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

get_formula

Use this when the user wants to see one of their formulas: every line with material, bottle strength, amount, relative and absolute percent, flags and notes, plus totals, concentration, cost and the note pyramid. Optionally adds an IFRA Category 4 and EU allergen check of it ("is my formula IFRA compliant"). Can read a past version by number or id.

read-only

Argument	Type	Description
formula*	string	The formula: its id (from list_formulas) or its exact name.
version	string	A version number such as "3", or its id. Omit for the working copy.
checkIfra	boolean
ifraConcentrationPct	number	How much of the finished product the formula is, for the IFRA check. Default: its target, else 20.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula"
  ],
  "properties": {
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    },
    "version": {
      "type": "string",
      "maxLength": 60,
      "description": "A version number such as \"3\", or its id. Omit for the working copy."
    },
    "checkIfra": {
      "type": "boolean"
    },
    "ifraConcentrationPct": {
      "type": "number",
      "maximum": 100,
      "minimum": 0.1,
      "description": "How much of the finished product the formula is, for the IFRA check. Default: its target, else 20."
    }
  }
}

get_material

Use this when the user asks what one perfumery material smells like, how it is used, how strong or long-lasting it is, or how much of it IFRA allows (its Category 4 fine-fragrance limit, e.g. "how much Iso E Super can I use"). Returns the odour description, family, note, impact, blotter life, synonyms, whether IFRA restricts it and its limit, whether the EU prohibits it, and a link to start a formula with it. The limit is the regulatory ceiling in the finished product, not a recommended dose. Without an exact match it returns the closest catalog names. To check a whole formula use check_formula.

read-only

Argument	Type	Description
name*	string	Canonical name, synonym or CAS number.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1,
      "description": "Canonical name, synonym or CAS number."
    }
  }
}

get_scent_profile

Use this when the user asks what a formula of theirs will smell like, how it evolves or how long it lasts, by PerfuMate's own scent model, exactly as the app's scent profile sheet shows it: families and sub-notes by weight and by perceived impact, the drydown at 0, 1, 4, 8 and 24 hours, the wear line (projection and longevity, e.g. "Bold · moderate wear") with its confidence, the genre, and the five-part note pyramid. Accords count by what they hold.

read-only

Argument	Type	Description
formula*	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula"
  ],
  "properties": {
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

get_shelf_material

Use this when the user asks about one material they own: their notes, its bottles with recent stock movements, and the formulas that use it.

read-only

Argument	Type	Description
material*	string	The material: name, CAS, or its id from list_shelf.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "material"
  ],
  "properties": {
    "material": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The material: name, CAS, or its id from list_shelf."
    }
  }
}

insert_accord

Use this when the user wants to use one of their saved formulas as a single ingredient inside another, as the app's accords do: a virtual material carrying the flattened composition (so IFRA, allergens, cost and the scent profile see what is inside) on a bottle at the accord's own aromatic strength. Optionally at an amount in grams.

Argument	Type	Description
grams	number
source*	string	The formula to use as the accord: its id or exact name.
formula*	string	The formula that receives the accord: its id or exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "source"
  ],
  "properties": {
    "grams": {
      "type": "number",
      "maximum": 100000,
      "minimum": 0
    },
    "source": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula to use as the accord: its id or exact name."
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula that receives the accord: its id or exact name."
    }
  }
}

journal_note

Use this when the user wants to add a dated line to a batch's maceration journal, or correct one.

Argument	Type	Description
date	string
text*	string
batch	string
noteId	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "text"
  ],
  "properties": {
    "date": {
      "type": "string",
      "maxLength": 30
    },
    "text": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1
    },
    "batch": {
      "type": "string",
      "maxLength": 60
    },
    "noteId": {
      "type": "string",
      "maxLength": 60
    }
  }
}

list_batches

Use this when the user asks about batches they have made, all or one formula's, with their maceration journal and days resting.

read-only

Argument	Type	Description
formula	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

list_deleted

Use this when the user wants to see what they deleted in the last 30 days and can still restore.

read-only

Argument	Type	Description
kind	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "kind": {
      "enum": [
        "formula",
        "version",
        "material",
        "bottle",
        "batch",
        "note",
        "journal_note",
        "shopping_item"
      ],
      "type": "string"
    }
  }
}

list_formulas

Use this when the user asks what formulas they have, wants to find one by name, folder or favourite, or before you read or change a formula (it returns the ids the other tools use). Lists the formulas on the user's PerfuMate bench, pinned first then most recently edited, with folders. Locked formulas show their name only.

read-only

Argument	Type	Description
kind	string
query	string
folder	string	A folder name; "" for unfiled.
favoritesOnly	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "kind": {
      "enum": [
        "perfume",
        "accord"
      ],
      "type": "string"
    },
    "query": {
      "type": "string",
      "maxLength": 80
    },
    "folder": {
      "type": "string",
      "maxLength": 80,
      "description": "A folder name; \"\" for unfiled."
    },
    "favoritesOnly": {
      "type": "boolean"
    }
  }
}

list_notes

Use this when the user asks to read their PerfuMate notebooks: titles and previews, or one notebook in full by id.

read-only

Argument	Type	Description
id	string
query	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 60
    },
    "query": {
      "type": "string",
      "maxLength": 80
    }
  }
}

list_shelf

Use this when the user asks which materials they own, what is in stock or running low, or as the first step to suggest what they can make with their shelf. Lists the materials on the user's shelf, each with its bottles: strength, solvent, stock, price, supplier, lot and running low.

read-only

Argument	Type	Description
query	string
lowOnly	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 80
    },
    "lowOnly": {
      "type": "boolean"
    }
  }
}

list_shopping

Use this when the user asks what they need to buy: the Shopping cart's lists and their items (with list and category), and the materials running low. Optionally one list only.

read-only

Argument	Type	Description
list	string	A list name or id; omit for every list.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "list": {
      "type": "string",
      "maxLength": 120,
      "description": "A list name or id; omit for every list."
    }
  }
}

list_versions

Use this when the user asks about a formula's history: its version tree with notes and parents, which version is the working copy and which have batches.

read-only

Argument	Type	Description
formula*	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula"
  ],
  "properties": {
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

log_batch

Use this when the user has made a batch of a formula and wants it recorded: total weight, date, label and notes, optionally at a weaker strength, and optionally deducting what it used from stock. Works from the working copy or a version.

Argument	Type	Description
code	string
notes	string
madeAt	string	ISO date, default today.
formula*	string	The formula: its id (from list_formulas) or its exact name.
version	string
totalGrams*	number
deductStock	boolean
concentrationPct	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "totalGrams"
  ],
  "properties": {
    "code": {
      "type": "string",
      "maxLength": 60
    },
    "notes": {
      "type": "string",
      "maxLength": 2000
    },
    "madeAt": {
      "type": "string",
      "maxLength": 30,
      "description": "ISO date, default today."
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    },
    "version": {
      "type": "string",
      "maxLength": 60
    },
    "totalGrams": {
      "type": "number",
      "maximum": 1000000,
      "exclusiveMinimum": 0
    },
    "deductStock": {
      "type": "boolean"
    },
    "concentrationPct": {
      "type": "number",
      "maximum": 100,
      "exclusiveMinimum": 0
    }
  }
}

make_dilution

Use this when the user has made, or wants to record, a dilution from a bottle they own; the material used is taken from the source bottle's stock.

Argument	Type	Description
grams*	number
solvent	string
material	string
targetPct*	number
fromBottle	string
fromDilutionPct	number
deductFromSource	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "targetPct",
    "grams"
  ],
  "properties": {
    "grams": {
      "type": "number",
      "maximum": 100000,
      "exclusiveMinimum": 0
    },
    "solvent": {
      "type": "string",
      "maxLength": 40
    },
    "material": {
      "type": "string",
      "maxLength": 160
    },
    "targetPct": {
      "type": "number",
      "maximum": 100,
      "exclusiveMinimum": 0
    },
    "fromBottle": {
      "type": "string",
      "maxLength": 60
    },
    "fromDilutionPct": {
      "type": "number",
      "maximum": 100,
      "exclusiveMinimum": 0
    },
    "deductFromSource": {
      "type": "boolean"
    }
  }
}

my_account

Use this when the user asks about their PerfuMate account or how big their bench is. Returns the linked account's plan ("unlimited" or "ai_studio") and its counts of formulas, shelf materials and notebooks; says so when the bench has not synced from the app yet.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

open_version

Use this when the user wants to go back and edit a past version directly, without cloning it. Refused for a version a batch was made from.

Argument	Type	Description
formula*	string	The formula: its id (from list_formulas) or its exact name.
version*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "version"
  ],
  "properties": {
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    },
    "version": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1
    }
  }
}

rebuild_from_shelf

Use this when the user asks what they can make with the materials they own, or wants a formula rebuilt using only their shelf: the app's Replace with materials I own, showing how the formula can stand entirely on the shelf (what stays, what a stand-in replaces, what has to go). Without apply it only shows the plan; with apply: true it rewrites the working copy in place (undo_last_change takes it back).

Argument	Type	Description
apply	boolean
formula*	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula"
  ],
  "properties": {
    "apply": {
      "type": "boolean"
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

rename_folder

Use this when the user wants to rename a formula folder: every formula filed in it moves (an empty name unfiles them).

Argument	Type	Description
to*	string
from*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "maxLength": 80
    },
    "from": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    }
  }
}

rename_version

Use this when the user wants to change a version's note or the number it carries.

Argument	Type	Description
note	any
number	integer
formula*	string	The formula: its id (from list_formulas) or its exact name.
version*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "version"
  ],
  "properties": {
    "note": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 120
        },
        {
          "type": "null"
        }
      ]
    },
    "number": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    },
    "version": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1
    }
  }
}

restore_deleted

Use this when the user wants something back from Recently deleted (deleted in the last 30 days).

Argument	Type	Description
items*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "kind",
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1
          },
          "kind": {
            "enum": [
              "formula",
              "version",
              "material",
              "bottle",
              "batch",
              "note",
              "journal_note",
              "shopping_item"
            ],
            "type": "string"
          }
        }
      },
      "maxItems": 50,
      "minItems": 1
    }
  }
}

resync_accord

Use this when the source formula of an accord has changed and the user wants the accord line to follow: re-reads its composition, families and price as it is now, as the app's Re-sync does.

Argument	Type	Description
line*	string	The line: its material name or line id.
formula*	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "line"
  ],
  "properties": {
    "line": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The line: its material name or line id."
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

save_version

Use this when the user wants to keep the current state of a formula as a named version in its evolution tree and carry on editing on a fresh copy.

Argument	Type	Description
note	string
formula*	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 120
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

scale_to_concentration

Use this when the user wants to change a formula's concentration (for example from an eau de parfum to an eau de toilette) or its finished weight: the app's Scale sheet. The concentrate scales and the finishing alcohol makes up the rest, added from the catalog's perfumer's ethanol when there is none. Capped at the concentrate's own strength. In place.

Argument	Type	Description
formula*	string	The formula: its id (from list_formulas) or its exact name.
totalGrams	number
concentrationPct*	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "concentrationPct"
  ],
  "properties": {
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    },
    "totalGrams": {
      "type": "number",
      "maximum": 100000,
      "exclusiveMinimum": 0
    },
    "concentrationPct": {
      "type": "number",
      "maximum": 100,
      "minimum": 0.01
    }
  }
}

search_materials

Use this when the user wants to find perfumery materials by scent, family, name or CAS number, for example musks, woods or citrus to put in a formula, or the catalog name of a material they typed loosely. Returns up to 10 catalog materials (aroma chemicals, essential oils, absolutes, bases) with CAS, family, note, impact, scent facets and a page link; a material IFRA prohibits or the EU bans is marked prohibited and ranked lower. For the full detail of one material use get_material; to check a whole formula use check_formula. Not for finished perfumes or shopping advice.

read-only

Argument	Type	Description
limit	integer
query*	string	A name, synonym, CAS number, family or facet, e.g. "musk".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "A name, synonym, CAS number, family or facet, e.g. \"musk\"."
    }
  }
}

set_preferences

Use this when the user wants to change the account's currency symbol or its default low-stock warning (grams; 0 turns it off).

Argument	Type	Description
currencySymbol	string
lowStockDefaultGrams	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "currencySymbol": {
      "type": "string",
      "maxLength": 4
    },
    "lowStockDefaultGrams": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
    }
  }
}

shopping_list

Use this when the user wants to add materials or free text to a Shopping cart list (the default list unless one is named; a new name makes that list), tick items as received or back to needed, or remove them.

destructive

Argument	Type	Description
add	array
done	array
list	string	The list to work in, by name or id. Omit for the default list.
remove	array
undone	array
category	string	A category for the items added, e.g. "Naturals".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "add": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 160
      },
      "maxItems": 100
    },
    "done": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200
      },
      "maxItems": 100
    },
    "list": {
      "type": "string",
      "maxLength": 120,
      "description": "The list to work in, by name or id. Omit for the default list."
    },
    "remove": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200
      },
      "maxItems": 100
    },
    "undone": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200
      },
      "maxItems": 100
    },
    "category": {
      "type": "string",
      "maxLength": 80,
      "description": "A category for the items added, e.g. \"Naturals\"."
    }
  }
}

undo_last_change

Use this when the user wants to take back the last change made from the chat, to one formula or the last of any, from any chat. Pass the exact changeId from a write result or this tool's preview. Without changeId this only previews the latest change and changes nothing. Reuse the SAME changeId after an error or retry: a completed undo is idempotent and never steps farther back. Only preview/select another ID when the user asks for another step (20 changes per formula,30 days). A concurrent edit aborts the whole restore; newer app work is not overwritten.

Argument	Type	Description
formula	string	Only changes to this formula: its id or exact name.
changeId	string	Exact undo changeId. Omit for preview only; use the same ID for retries.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only changes to this formula: its id or exact name."
    },
    "changeId": {
      "type": "string",
      "pattern": "^\\d{1,20}$",
      "description": "Exact undo changeId. Omit for preview only; use the same ID for retries."
    }
  }
}

update_bottle

Use this when the user wants to record stock for a bottle (a weighed count, or grams bought or used, through the stock ledger) or change its price per gram, supplier, lot, low-stock warning, strength, solvent or notes, take it on or off the shelf, or make it the preferred bottle.

Argument	Type	Description
lot	any
notes	any
bottle	string	The bottle id from list_shelf.
reason	string
onShelf	boolean
solvent	any
addGrams	number	Grams bought (positive) or used (negative).
material	string
supplier	any
countGrams	number	What the bottle holds now, weighed.
dilutionPct	number

update_formula

Use this when the user wants to rename a formula or change its description, bench notes, kind (perfume or accord), folder, favourite star, pin, target concentration, IFRA category or bottle size.

Argument	Type	Description
kind	string
name	string
folder	any
pinned	boolean
formula*	string	The formula: its id (from list_formulas) or its exact name.
favorite	boolean
description	any
bottleSizeMl	any
ifraCategory	string
personalNotes	any
targetConcentrationPct	any

update_material

Use this when the user wants to change a material on their bench: their notes, odour description, families, note, impact, blotter hours, shelf life, synonyms, flash point or constituent breakdown; name and CAS only for their own materials.

Argument	Type	Description
cas	any
name	string
note	string
odor	any
tier	any	The pyramid band it is filed in; null to derive it from its blotter hours.
impact	integer
natural	boolean
families	array
material*	string	The material: name, CAS or id.
synonyms	array
flashPointC	any

use_substitute

Use this when the user picks one of find_substitutes' suggestions: replaces the line with it (pass its member names), in place, with the app's own amounts, the same smell carried through each bottle's dilution, merged into a line that already holds that bottle.

Argument	Type	Description
line*	string	The line: its material name or line id.
formula*	string	The formula: its id (from list_formulas) or its exact name.
members*	array	The suggestion's member names.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "line",
    "members"
  ],
  "properties": {
    "line": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The line: its material name or line id."
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    },
    "members": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 160,
        "minLength": 1
      },
      "maxItems": 3,
      "minItems": 1,
      "description": "The suggestion's member names."
    }
  }
}

view_accord

Use this when the user asks what is inside an accord line of a formula: its materials at the dose it is used in, each with its share of the accord, read live from its source formula, and whether it can be decomposed.

read-only

Argument	Type	Description
line*	string	The line: its material name or line id.
formula*	string	The formula: its id (from list_formulas) or its exact name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula",
    "line"
  ],
  "properties": {
    "line": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The line: its material name or line id."
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    }
  }
}

write_note

Use this when the user wants to create a notebook or change one: its title, body, appended text or pin.

Argument	Type	Description
id	string
body	string
title	string
append	string
pinned	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 60
    },
    "body": {
      "type": "string",
      "maxLength": 100000
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "append": {
      "type": "string",
      "maxLength": 20000
    },
    "pinned": {
      "type": "boolean"
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "file": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string",
          "format": "uri"
        }
      },
      "description": "A file the user attached in the chat: CSV, TSV, TXT, JSON or Excel (.xlsx)."
    },
    "kind": {
      "enum": [
        "perfume",
        "accord"
      ],
      "type": "string"
    },
    "name": {
      "type": "string",
      "maxLength": 120
    },
    "text": {
      "type": "string",
      "maxLength": 20000,
      "description": "The formula as pasted text, one material per line with an amount."
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "material"
        ],
        "properties": {
          "flag": {
            "enum": [
              "too_strong",
              "too_weak",
              "replace"
            ],
            "type": "string"
          },
          "note": {
            "type": "string",
            "maxLength": 500
          },
          "grams": {
            "type": "number",
            "maximum": 100000,
            "minimum": 0,
            "description": "Weighed amount in grams. Never send together with percent."
          },
          "percent": {
            "type": "number",
            "maximum": 100,
            "minimum": 0,
            "description": "Weighed share of the formula, when every line is percent. Never send together with grams. Not the bottle dilution."
          },
          "solvent": {
            "type": "string",
            "maxLength": 40,
            "description": "The dilution's solvent, e.g. DPG, IPM, ethanol."
          },
          "material": {
            "type": "string",
            "maxLength": 160,
            "minLength": 1,
            "description": "Name, trade name or CAS as written, e.g. \"Iso E Super\" or \"Ambroxan 10% in DPG\"."
          },
          "dilutionPct": {
            "type": "number",
            "maximum": 100,
            "description": "Strength of the bottle weighed, e.g. 10 for a 10% dilution.",
            "exclusiveMinimum": 0
          },
          "newMaterial": {
            "anyOf": [
              {
                "type": "boolean",
                "const": true
              },
              {
                "type": "object",
                "properties": {
                  "cas": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "note": {
                    "enum": [
                      "top",
                      "heart",
                      "base",
                      "none"
                    ],
                    "type": "string"
                  },
                  "odor": {
                    "type": "string",
                    "maxLength": 500
                  },
                  "family": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "natural": {
                    "type": "boolean"
                  }
                }
              }
            ],
            "description": "Only for a material the catalog does not have: create it as the user's own material."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 200
    },
    "folder": {
      "type": "string",
      "maxLength": 80
    },
    "batchGrams": {
      "type": "number",
      "maximum": 100000,
      "description": "Batch size when lines are in percent. Default 10 g.",
      "exclusiveMinimum": 0
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "targetConcentrationPct": {
      "type": "number",
      "maximum": 100,
      "minimum": 0.01
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "lot": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ]
    },
    "notes": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 1000
        },
        {
          "type": "null"
        }
      ]
    },
    "bottle": {
      "type": "string",
      "maxLength": 60,
      "description": "The bottle id from list_shelf."
    },
    "reason": {
      "type": "string",
      "maxLength": 200
    },
    "onShelf": {
      "type": "boolean"
    },
    "solvent": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "null"
        }
      ]
    },
    "addGrams": {
      "type": "number",
      "maximum": 1000000,
      "minimum": -1000000,
      "description": "Grams bought (positive) or used (negative)."
    },
    "material": {
      "type": "string",
      "maxLength": 160
    },
    "supplier": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ]
    },
    "countGrams": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0,
      "description": "What the bottle holds now, weighed."
    },
    "dilutionPct": {
      "type": "number",
      "maximum": 100,
      "description": "With bottle: its new strength. Without bottle: which of the material's bottles to change.",
      "exclusiveMinimum": 0
    },
    "makeDefault": {
      "type": "boolean"
    },
    "pricePerGram": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1000000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "lowStockGrams": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1000000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "formula"
  ],
  "properties": {
    "kind": {
      "enum": [
        "perfume",
        "accord"
      ],
      "type": "string"
    },
    "name": {
      "type": "string",
      "maxLength": 120
    },
    "folder": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ]
    },
    "pinned": {
      "type": "boolean"
    },
    "formula": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The formula: its id (from list_formulas) or its exact name."
    },
    "favorite": {
      "type": "boolean"
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    },
    "bottleSizeMl": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100000,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "ifraCategory": {
      "type": "string",
      "maxLength": 4
    },
    "personalNotes": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "type": "null"
        }
      ]
    },
    "targetConcentrationPct": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100,
          "minimum": 0.01
        },
        {
          "type": "null"
        }
      ]
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "material"
  ],
  "properties": {
    "cas": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "null"
        }
      ]
    },
    "name": {
      "type": "string",
      "maxLength": 160
    },
    "note": {
      "enum": [
        "top",
        "heart",
        "base",
        "none"
      ],
      "type": "string"
    },
    "odor": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    },
    "tier": {
      "anyOf": [
        {
          "enum": [
            "top",
            "top_heart",
            "heart",
            "heart_base",
            "base"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The pyramid band it is filed in; null to derive it from its blotter hours."
    },
    "impact": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1
    },
    "natural": {
      "type": "boolean"
    },
    "families": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 8
    },
    "material": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The material: name, CAS or id."
    },
    "synonyms": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 160
      },
      "maxItems": 50
    },
    "flashPointC": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 500,
          "minimum": -100
        },
        {
          "type": "null"
        }
      ]
    },
    "blotterHours": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 10000,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "constituents": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "cas",
          "percent"
        ],
        "properties": {
          "cas": {
            "type": "string",
            "maxLength": 40
          },
          "name": {
            "type": "string",
            "maxLength": 160
          },
          "percent": {
            "type": "number",
            "maximum": 100,
            "exclusiveMinimum": 0
          }
        }
      },
      "maxItems": 300
    },
    "dropsPerGram": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 1000,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "personalNotes": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 5000
        },
        {
          "type": "null"
        }
      ]
    },
    "shelfLifeMonths": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 600,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    }
  }
}