Latest prices for one certified diamond across 100+ retailers: search, cert lookup, market prices.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
Details and the latest confirmed price range for one diamond, with the date we last saw it, by its Carat Hunter id (from search_diamonds or a carathunter.com URL).
Details and the latest confirmed price range for one diamond, with the date we last saw it, by its Carat Hunter id (from search_diamonds or a carathunter.com URL).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}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 as of the date we last saw it. Useful to check whether a quoted price is fair.
| Argument | Type | Description |
|---|---|---|
| certificate_number* | string |
{
"type": "object",
"required": [
"certificate_number"
],
"properties": {
"certificate_number": {
"type": "string",
"maxLength": 20,
"minLength": 5
}
},
"additionalProperties": false
}How many diamonds and retailers Carat Hunter currently tracks, from its latest weekly market report.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Typical listed prices for a spec (carat size, colour, clarity, shape, origin) across all retailers Carat Hunter tracks, with the day they were measured: 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.
| Argument | Type | Description |
|---|---|---|
| carat* | number | |
| shape* | string | |
| colour* | string | |
| origin* | string | |
| clarity* | string |
{
"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 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 with the date we last saw them, 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.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| sort | string | |
| shape | string | |
| colour | array | e.g. ["E","F","G"] |
| origin | string | |
| clarity | array | |
| max_carat | number | |
| min_carat | number | |
| max_price_usd | number | |
| min_price_usd | number |
{
"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
}