MCP Server

Carat Hunter

com.carathunter/diamond-prices
Commerce & Retail Public & reachable MCP 2026-07-28

What this MCP does

Searches certified diamonds and compares live prices across retailers, certificates, specifications, and market ranges.

get_diamond
Get a diamond
Details and current price range for one diamond by its Carat Hunter id (from search_diamonds or a carathunter.com URL).
Read only
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': False}
lookup_certificate
Look up a grading certificate
Find a diamond by its grading report number (GIA, IGI, HRD, GCAL...). Tells you whether retailers list that exact stone, how many, and the price range between them. Useful to check whether a quoted price is fair.
Read only
Input schema
{'type': 'object', 'required': ['certificate_number'], 'properties': {'certificate_number': {'type': 'string', 'maxLength': 20, 'minLength': 5}}, 'additionalProperties': False}
market_overview
Diamond market overview
How many diamonds and retailers Carat Hunter currently tracks, from its latest weekly market report.
Read only
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
price_check
Market price for a diamond spec
Typical market prices for a spec (carat size, colour, clarity, shape, origin) across all retailers Carat Hunter tracks: median, middle-half range, and how much the same stone varies between retailers. Carat sizes: 0.3, 0.5, 0.75, 1, 1.5, 2, 3, 5.
Read only
Input schema
{'type': 'object', 'required': ['carat', 'colour', 'clarity', 'shape', 'origin'], 'properties': {'carat': {'enum': [0.3, 0.5, 0.75, 1, 1.5, 2, 3, 5], 'type': 'number'}, 'shape': {'enum': ['round', 'oval', 'cushion', 'emerald', 'pear', 'princess', 'radiant', 'marquise', 'asscher', 'heart'], 'type': 'string'}, 'colour': {'enum': ['D', 'E', 'F', 'G', 'H', 'I', 'J', 'K'], 'type': 'string'}, 'origin': {'enum': ['natural', 'lab-grown'], 'type': 'string'}, 'clarity': {'enum': ['FL', 'IF', 'VVS1', 'VVS2', 'VS1', 'VS2', 'SI1', 'SI2'], 'type': 'string'}}, 'additionalProperties': False}
search_diamonds
Search diamonds
Search certified diamonds listed by retailers worldwide, with the latest cross-retailer prices we have seen. Returns up to 10 stones with specs, the lowest and highest confirmed price for that exact stone, how many retailers list it and a Carat Hunter grade. Prices in US dollars. Retailer names are shown on carathunter.com after a free sign-up; always give the user the link.
Read only
Input schema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 3, 'minimum': 1}, 'sort': {'enum': ['best', 'price_low', 'price_high'], 'type': 'string', 'default': 'best'}, 'shape': {'enum': ['round', 'oval', 'cushion', 'emerald', 'pear', 'princess', 'radiant', 'marquise', 'asscher', 'heart'], 'type': 'string'}, 'colour': {'type': 'array', 'items': {'enum': ['D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M'], 'type': 'string'}, 'description': 'e.g. ["E","F","G"]'}, 'origin': {'enum': ['natural', 'lab-grown'], 'type': 'string'}, 'clarity': {'type': 'array', 'items': {'enum': ['FL', 'IF', 'VVS1', 'VVS2', 'VS1', 'VS2', 'SI1', 'SI2', 'I1'], 'type': 'string'}}, 'max_carat': {'type': 'number', 'maximum': 30, 'minimum': 0.1}, 'min_carat': {'type': 'number', 'maximum': 30, 'minimum': 0.1}, 'max_price_usd': {'type': 'number', 'minimum': 0}, 'min_price_usd': {'type': 'number', 'minimum': 0}}, 'additionalProperties': False}
Changed
get_diamond
Sept. 30, 2026, 2:40 a.m.
Changed
search_diamonds
Sept. 30, 2026, 2:40 a.m.
Added
market_overview
Sept. 26, 2026, 2:40 a.m.
Added
price_check
Sept. 26, 2026, 2:40 a.m.
Added
lookup_certificate
Sept. 26, 2026, 2:40 a.m.
Added
get_diamond
Sept. 26, 2026, 2:40 a.m.
Added
search_diamonds
Sept. 26, 2026, 2:40 a.m.