Get a VYKA Score
vyka_scoreReturns VYKA's 0–100 quality score for a diamond and how it was calculated. Use this when the user asks for the VYKA Score of a stone in VYKA's inventory (give its report number or VYK code) or wants a diamond they describe scored on VYKA's scale (give type, shape, carat, colour and clarity, and any of cut, polish, symmetry, fluorescence, lab, eye-clean and proportions). Limits: it is VYKA's own guide computed from the report figures, not a laboratory grade; natural and lab-grown diamonds are scored on separate scales that do not compare; only white diamonds in the ten main shapes are scored; figures left out make the score less certain (figures_used shows how many were used).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "vyka_score"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cut | No | ||
| lab | No | The grading laboratory, if known. | |
| code | No | A report number or VYK code of a stone VYKA lists. Use either this or the specs below. | |
| type | No | ||
| carat | No | ||
| shape | No | ||
| colour | No | ||
| polish | No | ||
| clarity | No | ||
| symmetry | No | ||
| width_mm | No | ||
| eye_clean | No | True when the listing says the stone is eye-clean, false when it says it is not. Leave out when unknown. | |
| length_mm | No | ||
| crown_angle | No | ||
| fluorescence | No | ||
| depth_percent | No | ||
| table_percent | No | ||
| pavilion_angle | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| note | Yes | ||
| tier | Yes | Exceptional 90+, Excellent 80s, Very good 70s, Good 60s, Fair below 60. | |
| parts | Yes | ||
| scale | Yes | ||
| score | Yes | 0–100. | |
| stone | Yes | ||
| summary | Yes | ||
| strengths | Yes | ||
| tradeoffs | Yes | ||
| method_url | Yes | How the score works, on vykadiamonds.com. | |
| figures_used | Yes | ||
| figures_total | Yes |