Search VYKA diamonds
search_diamondsReturns loose diamonds currently listed on vykadiamonds.com (VYKA, Dubai), natural or lab-grown, with the same selection, order and prices as the website's diamond pages. Use this when the user wants to find or compare diamonds VYKA sells, by shape, carat, colour, clarity or budget. Only stones with a laboratory grading report are returned (natural: GIA, IGI or HRD; lab-grown: also GCAL). Unless the user sets a value, the website's own starting filters apply: natural 0.5 ct and up, colour D–H, clarity VS2 or better, Excellent or Ideal cut where the laboratory grades cut, Very Good or Excellent polish and symmetry; lab-grown 1.0 ct and up, colour D–F, clarity VS1 or better, Excellent or Ideal cut where graded, Excellent polish and symmetry; both: eye-clean, no tinge, returnable, with photo and 360° view, lowest price first. Any value the user gives replaces that default. Limits: at most 10 stones per call; stock changes quickly and a listed stone can sell at any time; AED prices are the charged prices, other currencies are indicative. Does not cover ring settings, finished rings, gemstones or fancy-colour diamonds, and cannot reserve or buy a stone.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"type": "<type>"
},
"name": "search_diamonds"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | price_low_to_high | |
| type | Yes | natural = mined diamonds; lab = lab-grown diamonds. | |
| limit | No | How many stones to return (1–10). | |
| shape | No | One or more shapes. Leave out for every shape. | |
| currency | No | Currency of max_price and of the indicative price shown beside the AED price. | AED |
| carat_max | No | Largest carat weight (20 = no upper limit). | |
| carat_min | No | Smallest carat weight. | |
| max_price | No | Highest price, in `currency`. | |
| colour_lowest | No | Lowest colour grade to include, e.g. G for 'G or better'. | |
| clarity_lowest | No | Lowest clarity grade to include, e.g. VS1 for 'VS1 or better'. | |
| colour_highest | No | Highest colour grade to include (D is the highest). | |
| clarity_highest | No | Highest clarity grade to include (FL is the highest). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| count | Yes | ||
| diamonds | Yes | ||
| browse_link | Yes | The matching diamond page on vykadiamonds.com. | |
| currency_note | Yes |