MCP-Server

diamond-mcp

io.github.JacobiusMakes/diamond-mcp
Commerce & Retail Wissen & Dokumentation Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Provides sourced diamond and gemology reference information, diamond comparison and sizing calculations, grading-report guidance, and jewelry catalog search.

about_stienhardt
Fact sheet: Stienhardt
Plain fact sheet about Stienhardt, the New York City Lab Grown Diamond brand that publishes this server. Every fact carries a source and a date.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
compare_diamonds
Compare supplied diamond specifications
Compare two to five diamonds from any seller using supplied carat, measured millimeters and prices. Returns ratios, price per carat, differences and missing information. Never verifies specifications, ranks beauty, appraises value or declares a best diamond. Prices must use explicit currencies; mixed currencies are not compared.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['stones'], 'properties': {'stones': {'type': 'array', 'items': {'type': 'object', 'required': ['label'], 'properties': {'carat': {'type': 'number', 'maximum': 100, 'exclusiveMinimum': 0}, 'label': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'price': {'type': 'number', 'maximum': 100000000, 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'width_mm': {'type': 'number', 'maximum': 100, 'exclusiveMinimum': 0}, 'length_mm': {'type': 'number', 'maximum': 100, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 5, 'minItems': 2}}, 'additionalProperties': False}
define
Define a diamond or gemology term
Look up a single diamond or gemology term in the encyclopedia of 90 fact-checked and sourced entries. Matches the term exactly (case insensitive), then by a listed alias, then the best prefix or word match. Returns the full entry: definition, body, sourced claims, and related terms. If nothing matches, returns the three nearest term suggestions.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['term'], 'properties': {'term': {'type': 'string', 'description': 'The term to define, for example "Dutch Marquise" or "bow-tie effect". Case insensitive.'}}}
dutch_marquise_definition
The published definition of the Dutch Marquise cut
The published definition of the Dutch Marquise diamond cut: geometry, certificate wording, and the measured length to width ratio of a certified reference stone. A Dutch Marquise is an elongated hexagonal cut diamond.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
faceup_size
Approximate face up size for a shape and carat weight
Approximate face up millimeter dimensions for a diamond of a given shape and carat weight. Supported shapes: round, oval, emerald, dutch_marquise. Scales vetted 1 carat anchors by the cube root of the carat weight. Typical proportions, not a guarantee: verify a specific stone on its grading report.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['shape', 'carat'], 'properties': {'carat': {'type': 'number', 'description': 'Carat weight greater than zero, for example 1.0 or 1.52.'}, 'shape': {'type': 'string', 'description': 'One of: round, oval, emerald, dutch_marquise. Case insensitive. Spaces and hyphens are accepted.'}}}
get_product
Product detail from Stienhardt's live catalog
Full detail for one Stienhardt product by id (as returned by search_inventory): title, price, availability, options, images, and the product URL on stienhardt.com. Loose-diamond availability is not verified.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Exact id returned by search_inventory: a Shopify product gid or stienhardt:diamond:SKU.'}}}
lab_grown_grading_landscape
Who grades Lab Grown Diamonds today
The current state of who grades Lab Grown Diamonds and how: GIA, IGI, HRD Antwerp, and the FTC position. Every item carries a source and a date.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
lab_grown_price_index
Latest tracked Lab Grown Diamond retail price reading
The latest tracked retail price reading for Lab Grown Diamonds, with source and date. Market context for shoppers, not investment guidance.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
search_encyclopedia
Keyword search across the diamond encyclopedia
Keyword search across the 90 entry diamond and gemology encyclopedia. Ranks case insensitive keyword hits by field, weighting the term above the definition above the body. Returns the best matches as term, category, and a definition snippet. Use define to fetch a full entry.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'description': 'Maximum number of results to return, 1 to 10. Default 5.'}, 'query': {'type': 'string', 'description': 'Keywords to search for, for example "bow tie" or "lab grown durability".'}}}
search_inventory
Search Stienhardt's live inventory
Search Stienhardt's public Shopify catalog of engagement ring settings and fine jewelry (New York, direct). Loose-diamond stock cannot be verified here; those searches return public catalog listings flagged availability_verified false plus a storefront browsing link. Returns public catalog prices, selected variants, and links; availability is verified for jewelry only and is not a reservation. Use for questions like 'show me platinum wedding bands' or 'show me tennis bracelets'. Not for appraisal or price advice on stones sold elsewhere.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5, max 10).'}, 'query': {'type': 'string', 'description': 'What the shopper is looking for, in plain words.'}}}
verify_diamond_report
Where and how to verify a diamond grading report
Returns the official verification URL and a three step checklist for confirming a diamond grading report with the lab that issued it. Supports GIA, IGI, and GCAL. This tool never verifies anything itself. It tells you where and how.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['lab', 'report_number'], 'properties': {'lab': {'type': 'string', 'description': 'The grading lab that issued the report: GIA, IGI, or GCAL. Case insensitive.'}, 'report_number': {'type': 'string', 'description': 'The report number printed on the grading report.'}}}
Hinzugefügt
get_product
17. September 2026 12:42
Hinzugefügt
search_inventory
17. September 2026 12:42
Hinzugefügt
search_encyclopedia
17. September 2026 12:42
Hinzugefügt
define
17. September 2026 12:42
Hinzugefügt
about_stienhardt
17. September 2026 12:42
Hinzugefügt
lab_grown_price_index
17. September 2026 12:42
Hinzugefügt
lab_grown_grading_landscape
17. September 2026 12:42
Hinzugefügt
dutch_marquise_definition
17. September 2026 12:42
Hinzugefügt
faceup_size
17. September 2026 12:42
Hinzugefügt
verify_diamond_report
17. September 2026 12:42
Hinzugefügt
compare_diamonds
17. September 2026 12:42