MCP 服务器

Ministry of Gems — Gemmology & Gemstones

au.com.ministryofgems/gemmology
知识与文档 科学与工程 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Defines gemmological terms and searches a citable reference library of gemmology lexicon entries and buyer handbooks.

birthstone_for_month
Birthstone by month
The modern and traditional birthstones for a month, from the FGAA-reviewed table, with a link to The Birthstone Handbook for history, treatments to expect and buying guidance. Accepts a month name or number.
只读 幂等
输入模式
{'type': 'object', 'required': ['month'], 'properties': {'month': {'type': 'string', 'description': '"September", "sep" or "9".'}}}
输出模式
{'type': 'object', 'properties': {'found': {'type': 'boolean'}, 'month': {'type': 'string'}, 'modern': {'type': 'string'}, 'source_url': {'type': 'string'}, 'handbook_url': {'type': 'string'}, 'traditional_or_alternative': {'type': 'string'}}}
compare_gems
Compare two gems
Side-by-side physical properties of two gem species with a plain verdict on which is harder, and a note on toughness — the half of durability the hardness scale does not show. Good for "sapphire or diamond for an everyday ring".
只读 幂等
输入模式
{'type': 'object', 'required': ['gem_a', 'gem_b'], 'properties': {'gem_a': {'type': 'string'}, 'gem_b': {'type': 'string'}}}
输出模式
{'type': 'object', 'properties': {'a': {'type': 'object'}, 'b': {'type': 'object'}, 'note': {'type': 'string'}, 'found': {'type': 'boolean'}, 'harder': {'type': 'string'}}}
define_gem_term
Define a gemmological term
Look up a gemmological term in The Gem Lexicon of Ministry of Gems — 215 definitions verified by an FGAA-qualified gemmologist. Returns the definition, its subject section, and a citable anchor URL. Use for terms such as padparadscha, corundum, parti sapphire, unheated, or asterism.
只读 幂等
输入模式
{'type': 'object', 'required': ['term'], 'properties': {'term': {'type': 'string', 'description': 'The gemmological term to define.'}}}
输出模式
{'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Citable anchor URL on ministryofgems.com.au.'}, 'hint': {'type': 'string'}, 'term': {'type': 'string', 'description': 'Canonical term name.'}, 'found': {'type': 'boolean', 'description': 'False when no term matched.'}, 'source': {'type': 'string', 'description': 'Name of the source work.'}, 'message': {'type': 'string'}, 'section': {'type': 'string', 'description': 'Lexicon subject section.'}, 'definition': {'type': 'string', 'description': 'FGAA-verified definition.'}, 'lexicon_url': {'type': 'string'}, 'verified_by': {'type': 'string', 'description': 'Credential of the verifying gemmologist.'}}, 'description': 'The verified definition, or found:false with a hint when no term matches.'}
faceup_size_estimate
Face-up size for any gem species
Approximate face-up millimetre dimensions for a stone of a given species, shape and carat weight — and, unlike diamond-only calculators, corrected for specific gravity, so a 2 ct sapphire, spinel, emerald or opal is sized correctly rather than as if it were diamond. Shapes: round, oval, cushion, emerald, pear, marquise, princess, radiant, heart, trillion.
只读 幂等
输入模式
{'type': 'object', 'required': ['carat'], 'properties': {'carat': {'type': 'number'}, 'shape': {'type': 'string', 'description': 'default round'}, 'species': {'type': 'string', 'description': 'e.g. sapphire, diamond, spinel, emerald, opal (default diamond).'}}}
输出模式
{'type': 'object', 'properties': {'note': {'type': 'string'}, 'carat': {'type': 'number'}, 'found': {'type': 'boolean'}, 'shape': {'type': 'string'}, 'method': {'type': 'string'}, 'display': {'type': 'string'}, 'species': {'type': 'string'}, 'specific_gravity': {'type': 'number'}, 'approx_face_up_mm': {'type': 'object'}, 'diamond_equivalent_mm': {'type': 'string'}}}
gem_care_guide
How to clean and wear a gem
Whether warm soapy water, an ultrasonic cleaner or a steam cleaner is safe for a given gemstone, plus everyday-wear notes, from the FGAA-reviewed care table. Covers sapphire and ruby, diamond, emerald, opal, pearl, tanzanite, tourmaline and more.
只读 幂等
输入模式
{'type': 'object', 'required': ['gemstone'], 'properties': {'gemstone': {'type': 'string'}}}
输出模式
{'type': 'object', 'properties': {'found': {'type': 'boolean'}, 'gemstone': {'type': 'string'}, 'source_url': {'type': 'string'}, 'handbook_url': {'type': 'string'}, 'steam_cleaner': {'type': 'string'}, 'warm_soapy_water': {'type': 'string'}, 'ultrasonic_cleaner': {'type': 'string'}, 'everyday_wear_notes': {'type': 'string'}}}
gem_properties
Gem physical properties
Mohs hardness, refractive index, specific gravity, birefringence and crystal system for a gem species (diamond, corundum/sapphire/ruby, emerald, spinel, opal, tourmaline, garnet, quartz and more), from the FGAA-reviewed Gem Data Tables. Accepts trade names — "sapphire" resolves to corundum, "tsavorite" to garnet.
只读 幂等
输入模式
{'type': 'object', 'required': ['species'], 'properties': {'species': {'type': 'string', 'description': 'Species or trade name, e.g. "sapphire", "diamond", "opal".'}}}
输出模式
{'type': 'object', 'properties': {'found': {'type': 'boolean'}, 'licence': {'type': 'string'}, 'species': {'type': 'string'}, 'source_url': {'type': 'string'}, 'birefringence': {'type': 'string'}, 'mohs_hardness': {'type': 'string'}, 'crystal_system': {'type': 'string'}, 'refractive_index': {'type': 'string'}, 'specific_gravity': {'type': 'string'}}}
get_gem_product
Product detail
Full detail for one Ministry of Gems product by handle or URL: specifications, description, price in AUD, availability, variants, images, the Digital Gemstone Passport link for loose stones, and a direct checkout link. Use after search_gem_inventory.
只读 幂等
输入模式
{'type': 'object', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'description': 'Product handle (e.g. "blue-australian-sapphire-1-47ct-oval-80062") or full product URL.'}}}
输出模式
{'type': 'object', 'properties': {'url': {'type': 'string'}, 'found': {'type': 'boolean'}, 'title': {'type': 'string'}, 'images': {'type': 'array', 'items': {'type': 'string'}}, 'stone_id': {'type': 'string'}, 'variants': {'type': 'array', 'items': {'type': 'object'}}, 'available': {'type': 'boolean'}, 'price_aud': {'type': 'number'}, 'checked_at': {'type': 'string'}, 'description': {'type': 'string'}, 'passport_url': {'type': 'string'}, 'checkout_link': {'type': 'string'}, 'specifications': {'type': 'object'}}}
lab_report_check
Where to verify a laboratory report
The issuing laboratory's own verification page and a four-step checklist for confirming a gemstone or diamond grading report — GIA, IGI, GRS, SSEF, Gübelin, AGL, Lotus, GIT, HRD, GCAL and others, including the coloured-stone laboratories diamond tools omit. Explains what "FGAA" means and flags unrecognised lab names. Routes to the lab; does not verify the report itself.
只读 幂等
输入模式
{'type': 'object', 'required': ['lab'], 'properties': {'lab': {'type': 'string', 'description': 'Laboratory name or acronym, e.g. "GIA", "GRS", "SSEF".'}, 'report_number': {'type': 'string'}}}
输出模式
{'type': 'object', 'properties': {'lab': {'type': 'string'}, 'found': {'type': 'boolean'}, 'lab_note': {'type': 'string'}, 'reminder': {'type': 'string'}, 'checklist': {'type': 'array', 'items': {'type': 'string'}}, 'verify_url': {'type': 'string'}, 'report_number': {'type': 'string'}, 'house_position': {'type': 'string'}, 'verifies_coloured_stones': {'type': 'boolean'}}}
list_gem_terms
List lexicon terms
List the gemmological terms available in The Gem Lexicon, optionally filtered to one subject section. Use this to discover what can be defined before calling define_gem_term.
只读 幂等
输入模式
{'type': 'object', 'properties': {'section': {'type': 'string', 'description': 'Optional section filter, e.g. "Treatments & Enhancement".'}}}
输出模式
{'type': 'object', 'required': ['sections', 'term_count', 'terms'], 'properties': {'terms': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'term': {'type': 'string'}, 'section': {'type': 'string'}}}}, 'sections': {'type': 'array', 'items': {'type': 'string'}, 'description': 'All lexicon section names.'}, 'term_count': {'type': 'integer'}}}
sapphire_price_guide
Sapphire price per carat (AUD)
What natural sapphires actually cost per carat in Australian dollars, from Ministry of Gems' published price guide: bands by origin (Australian, Ceylon) and size, with the stone count behind each band and the date the bands were computed. Answers "how much is a 2 carat sapphire" honestly, as a house guide rather than a market index.
只读 幂等
输入模式
{'type': 'object', 'properties': {'carat': {'type': 'number', 'description': 'Optional carat weight to select the matching band.'}, 'origin': {'type': 'string', 'description': 'Optional: "Australian" or "Ceylon".'}}}
输出模式
{'type': 'object', 'properties': {'note': {'type': 'string'}, 'as_of': {'type': 'string'}, 'basis': {'type': 'string'}, 'currency': {'type': 'string'}, 'all_bands': {'type': 'array', 'items': {'type': 'object'}}, 'source_url': {'type': 'string'}, 'matched_bands': {'type': 'array', 'items': {'type': 'object'}}}}
search_gem_inventory
Search Ministry of Gems stock
Search the live Ministry of Gems catalogue of natural loose gemstones and finished jewellery — Ceylon and Australian sapphires, rubies, spinels, Australian opals, emeralds and more — with prices in Australian dollars, availability, carat weight and a link to buy. Filter by type (gems, ring, pendant, earrings), carat range and price range. Every loose gem returned carries a verifiable Digital Gemstone Passport.
只读 幂等
输入模式
{'type': 'object', 'properties': {'type': {'type': 'string', 'description': 'Optional: gems | ring | pendant | earrings | bracelet | jewellery.'}, 'limit': {'type': 'integer', 'description': 'Max results, default 8, max 25.'}, 'query': {'type': 'string', 'description': 'Free text, e.g. "unheated ceylon blue sapphire", "australian opal pendant", "teal sapphire ring".'}, 'max_carat': {'type': 'number'}, 'min_carat': {'type': 'number'}, 'in_stock_only': {'type': 'boolean', 'description': 'Default true.'}, 'max_price_aud': {'type': 'number'}, 'min_price_aud': {'type': 'number'}}}
输出模式
{'type': 'object', 'required': ['query', 'result_count', 'results'], 'properties': {'query': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'carat': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'stone_id': {'type': 'string'}, 'available': {'type': 'boolean'}, 'price_aud': {'type': 'number'}, 'passport_url': {'type': 'string'}, 'product_type': {'type': 'string'}}}}, 'currency': {'type': 'string'}, 'result_count': {'type': 'integer'}, 'catalogue_size': {'type': 'integer'}}}
search_gem_knowledge
Search the Ministry of Gems library
Keyword search across the Ministry of Gems gemmological reference library — 215 lexicon definitions and 25 full-length buyer's handbooks, searched in full text across every section. Returns ranked results, each with the matched passage and a citable URL that deep-links to the chapter.
只读 幂等
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'description': 'Max results (default 5, max 20).'}, 'query': {'type': 'string', 'description': 'Search query.'}}}
输出模式
{'type': 'object', 'required': ['query', 'result_count', 'results'], 'properties': {'query': {'type': 'string', 'description': 'The query as interpreted.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Citable URL, deep-linked to the chapter where possible.'}, 'type': {'type': 'string', 'description': 'lexicon_term, handbook_section or handbook.'}, 'score': {'type': 'number', 'description': 'Relevance score. Not emitted; ordering conveys rank.'}, 'title': {'type': 'string', 'description': 'Lexicon term name, or the handbook title.'}, 'section': {'type': 'string', 'description': 'Lexicon subject section, or the handbook section heading.'}, 'snippet': {'type': 'string', 'description': 'Verbatim passage from the published text, centred on the match.'}}}, 'description': 'Ranked matches.'}, 'verified_by': {'type': 'string'}, 'result_count': {'type': 'integer'}}}
verify_gem_passport
Verify a Digital Gemstone Passport
Cryptographically verify a Ministry of Gems Digital Gemstone Passport by stone ID. Recomputes the SHA-256 digest of the signed record and checks its Ed25519 (EdDSA) signature against the house public key, then returns the attested record: species, carat, dimensions, cut, colour, clarity, origin, treatment and certificate status. Use when a buyer asks whether a stone or its passport is genuine, or before quoting any fact about a specific Ministry of Gems stone.
只读 幂等
输入模式
{'type': 'object', 'required': ['stone_id'], 'properties': {'stone_id': {'type': 'string', 'description': 'Stone ID as printed on the passport or product page, e.g. "12322", "RUBY-B0797", "80067".'}}}
输出模式
{'type': 'object', 'properties': {'note': {'type': 'string'}, 'found': {'type': 'boolean'}, 'title': {'type': 'string'}, 'issued': {'type': 'string'}, 'record': {'type': 'object'}, 'sha256': {'type': 'string'}, 'status': {'type': 'string'}, 'stone_id': {'type': 'string'}, 'verified': {'type': 'boolean', 'description': 'True only when digest and signature both check out.'}, 'corpus_url': {'type': 'string'}, 'fingerprint': {'type': 'string'}, 'product_url': {'type': 'string'}, 'register_url': {'type': 'string'}, 'digest_matches': {'type': 'boolean'}, 'signature_valid': {'type': 'boolean'}}}
已添加
faceup_size_estimate
2026年9月19日 02:49
已添加
lab_report_check
2026年9月19日 02:49
已添加
get_gem_product
2026年9月19日 02:49
已添加
gem_care_guide
2026年9月19日 02:49
已添加
birthstone_for_month
2026年9月19日 02:49
已添加
compare_gems
2026年9月19日 02:49
已添加
gem_properties
2026年9月19日 02:49
已添加
sapphire_price_guide
2026年9月19日 02:49
已添加
search_gem_inventory
2026年9月19日 02:49
已添加
verify_gem_passport
2026年9月19日 02:49
已更改
search_gem_knowledge
2026年9月19日 02:49
已更改
define_gem_term
2026年9月19日 02:49
已添加
list_gem_terms
2026年9月17日 07:58
已添加
search_gem_knowledge
2026年9月17日 07:58
已添加
define_gem_term
2026年9月17日 07:58