Carat Hunter
Live prices for one certified diamond across 100+ retailers: search, cert lookup, market prices.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"diamond-prices": {
"url": "https://carathunter.com/mcp"
}
}
}Remote endpoints
https://carathunter.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢search_diamonds(shape, min_carat, max_carat, colour, clarity, ...)
Search certified diamonds listed by retailers worldwide, with live cross-retailer prices. 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.
Input Schema
{
"type": "object",
"properties": {
"shape": {
"type": "string",
"enum": [
"round",
"oval",
"cushion",
"emerald",
"pear",
"princess",
"radiant",
"marquise",
"asscher",
"heart"
]
},
"min_carat": {
"type": "number",
"minimum": 0.1,
"maximum": 30
},
"max_carat": {
"type": "number",
"minimum": 0.1,
"maximum": 30
},
"colour": {
"type": "array",
"items": {
"type": "string",
"enum": [
"D",
"E",
"F",
"G",
"H",
"I",
"J",
"K",
"L",
"M"
]
},
"description": "e.g. [\"E\",\"F\",\"G\"]"
},
"clarity": {
"type": "array",
"items": {
"type": "string",
"enum": [
"FL",
"IF",
"VVS1",
"VVS2",
"VS1",
"VS2",
"SI1",
"SI2",
"I1"
]
}
},
"origin": {
"type": "string",
"enum": [
"natural",
"lab-grown"
]
},
"min_price_usd": {
"type": "number",
"minimum": 0
},
"max_price_usd": {
"type": "number",
"minimum": 0
},
"sort": {
"type": "string",
"enum": [
"best",
"price_low",
"price_high"
],
"default": "best"
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 3,
"default": 1
}
},
"additionalProperties": false
}🟢get_diamond(id)
Details and live price range for one diamond by its Carat Hunter id (from search_diamonds or a carathunter.com URL).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 1
}
},
"required": [
"id"
],
"additionalProperties": false
}🟢lookup_certificate(certificate_number)
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.
Input Schema
{
"type": "object",
"properties": {
"certificate_number": {
"type": "string",
"minLength": 5,
"maxLength": 20
}
},
"required": [
"certificate_number"
],
"additionalProperties": false
}🟢price_check(carat, colour, clarity, shape, origin)
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.
Input Schema
{
"type": "object",
"properties": {
"carat": {
"type": "number",
"enum": [
0.3,
0.5,
0.75,
1,
1.5,
2,
3,
5
]
},
"colour": {
"type": "string",
"enum": [
"D",
"E",
"F",
"G",
"H",
"I",
"J",
"K"
]
},
"clarity": {
"type": "string",
"enum": [
"FL",
"IF",
"VVS1",
"VVS2",
"VS1",
"VS2",
"SI1",
"SI2"
]
},
"shape": {
"type": "string",
"enum": [
"round",
"oval",
"cushion",
"emerald",
"pear",
"princess",
"radiant",
"marquise",
"asscher",
"heart"
]
},
"origin": {
"type": "string",
"enum": [
"natural",
"lab-grown"
]
}
},
"required": [
"carat",
"colour",
"clarity",
"shape",
"origin"
],
"additionalProperties": false
}🟢market_overview
How many diamonds and retailers Carat Hunter currently tracks, from its latest weekly market report.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Community
Evidence