MCP Gemstones Tools
Gemstone Delete
gemstone_delete — Writes data.
Delete one or more gemstones by id. Deleted gemstones cannot be restored.
items (array, required)
items[].id (integer, required)
Gemstone Export
gemstone_export — Read-only.
Export a single gemstone with all its properties: grading (color, clarity, cut, shape, carat), proportions, certificates, price, custom fields and related product ids. Provide exactly one of gemstone_id or gemstone_code.
gemstone_id (integer)
gemstone_code (string)
Gemstone Import
gemstone_import — Writes data.
Create a gemstone. Requires a unique code, a name and a type (‘0’ non-precious, ‘1’ precious, ‘2’ diamond, ‘3’ pearl, or free text). Accepts grading properties (color, clarity, cut, shape, carat), proportions (proprotion_* fields – note the original spelling), certificates, price and custom fields. Returns the new gemstone id.
code (string, required)
name (string, required)
type (string, required)
title (string)
color (string)
carat (string)
carat_text (string)
dimensions (string)
fluorescence (string)
symmetry (string)
clarity (string)
cut (string)
shape (string)
treatment (string)
creation_method (string)
polish (string)
price (number)
carat_price (number)
quantity (string)
intensity (string)
unique (string)
overtone (string)
certificate_num (string)
certificate_num2 (string)
certificate_text (string)
certificate_text2 (string)
certificate_file (string)
certificate_file2 (string)
certificate_file_external (string)
certificate_file2_external (string)
comments (string)
fields (object) — Custom field values keyed by field code.
Gemstone Listfields
gemstone_listfields — Read-only.
List all available gemstone field definitions (code, title, type) usable in gemstone_import / gemstone_update payloads.
Takes no parameters.
Gemstone Search
gemstone_search — Read-only.
Search gemstones by code. Returns matching code and gemstone_id pairs.
code (string or array of strings)
Gemstone Update
gemstone_update — Writes data.
Update an existing gemstone by gemstone_id using sparse (PATCH) semantics: only the provided fields are changed. Accepts the same fields as gemstone_import; code and name must stay unique.
gemstone_id (integer, required)
code (string)
name (string)
type (string)
title (string)
color (string)
carat (string)
clarity (string)
cut (string)
shape (string)
price (number)
carat_price (number)
quantity (string)
comments (string)
fields (object) — Custom field values keyed by field code.
Gemstones Export
gemstones_export — Read-only.
Export gemstones as a paginated list, optionally filtered by code or title. Each item has the same shape as a gemstone_export result; the response also carries total_items_count.
offset (integer) — Default: 0.
limit (integer) — Default: 20.
sort (string) — Default: “id asc”. One of: id asc, id desc.
code (string)
title (string)
