VYKA Diamonds connector

The VYKA Diamonds connector lets an AI assistant look up the loose diamonds listed on vykadiamonds.com. It works with assistants that support the Model Context Protocol (MCP), such as Claude and Cursor. It needs no account and only reads data: it cannot buy, reserve or change anything.

On this page: What it does · Where the data comes from · How to connect · Tools · Examples · Limits · Troubleshooting · Privacy · Support

Server address
https://vyka-diamonds-mcp.saimmehmudkhan.workers.dev/mcp
Transport
Streamable HTTP
Sign-in
None. No account, key or token.
Access
Read-only. Five tools.
Made by
VYKA Diamonds, operated by Vyka Trading FZE LLC, United Arab Emirates
Version
1.0.0. Page updated 4 November 2026.

This is VYKA's own server, hosted on Cloudflare Workers. The address above is the only official one. The connector is made by VYKA. The makers of the assistants it works with, and the laboratories it links to, did not make it and do not endorse it.

What it does

It is for people choosing a loose diamond who want to narrow the options and check the facts before contacting a jeweller or visiting the website. With it, an assistant can:

  • Search the diamonds VYKA lists by type (natural or lab-grown), shape, carat, colour, clarity and maximum price.
  • Look up a stone VYKA lists by its report number or VYKA stone code, with its grades, measurements, AED price and page link.
  • Build the GIA or IGI report-check link for a report number, for any stone, including stones VYKA does not sell.
  • Give the VYKA Score for a listed stone, or for any diamond described by its specifications.
  • Give a WhatsApp link to a VYKA jeweller with a pre-written first message, when you ask to contact VYKA. You open the link, can edit the message and send it yourself.

Where the data comes from

  • It shows VYKA's stones only. It is one seller's listing, not a comparison of sellers.
  • The listings come from a supplier. Stones and availability come from a supplier's live feed, the same feed VYKA's website uses. Prices are the prices VYKA's website shows. Search results follow the website's order, except that only stones with a laboratory report are returned here.
  • Photos and videos are hosted by a third party. A stone's photo_url and video_360_url point to a media host the supplier uses, not to vykadiamonds.com.
  • The VYKA Score is VYKA's own guide. It is worked out from a report's figures by a company that sells diamonds, so read it as a seller's guide. It is not a laboratory grade or an independent rating. How the score is worked out.
  • Report checks belong to the laboratories. The connector only builds the link to GIA's or IGI's own page. It does not open, read or confirm the report.

How to connect

Claude

  1. Open Customize > Connectors and choose Add custom connector. Or use this prefilled link, which only fills in the form.
  2. Enter the server address above. If you are asked about authentication, choose No sign-in.
  3. Choose Add.
  4. In a chat, open + > Connectors and turn VYKA Diamonds on.

On Team and Enterprise plans an Owner adds it under Organization settings > Connectors. The Free plan allows one custom connector.

Claude Code

claude mcp add --transport http vyka-diamonds https://vyka-diamonds-mcp.saimmehmudkhan.workers.dev/mcp

Cursor

Add this to .cursor/mcp.json:

{
  "mcpServers": {
    "vyka-diamonds": {
      "url": "https://vyka-diamonds-mcp.saimmehmudkhan.workers.dev/mcp"
    }
  }
}

Other MCP clients

Use the server address with the Streamable HTTP transport and no extra headers. To test from a terminal:

npx @modelcontextprotocol/inspector --cli https://vyka-diamonds-mcp.saimmehmudkhan.workers.dev/mcp --transport http --method tools/list

Opening the address in a browser returns error 405. That is expected: the server only answers MCP requests.

Tools

All five tools are read-only.

search_diamonds

Returns loose diamonds currently listed on vykadiamonds.com, at most 10 per call, each with grades, laboratory and report number, AED price, VYKA Score and page link.

  • Required: type: natural or lab.
  • Optional: shape (round, oval, cushion, princess, emerald, pear, radiant, marquise, asscher, heart), carat_min and carat_max (0.3 to 20), colour_highest and colour_lowest (D to M), clarity_highest and clarity_lowest (FL to I1), max_price, currency, sort, limit (1 to 10).
  • Currencies: AED, SAR, QAR, USD, EUR, GBP, KWD, BHD, OMR, INR, PKR, AUD, CAD.
  • Sort: price_low_to_high (default), price_high_to_low, carat_high_to_low, carat_low_to_high.
  • Starting filters: unless a value is given, the website's own starting filters apply. Natural: 0.5 ct and up, colour D to 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 to 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 given replaces that default.

get_diamond

Returns one listed stone, with measurements and proportions as well as grades, price, photo, page link and report-check link. Use it to re-check a stone before relying on it.

  • Required: code: a report number or a VYKA stone code (VYK-...).
  • Optional: currency.
  • If VYKA does not list that number, found is false. The stone may have sold, or VYKA may never have listed it. That says nothing about whether the report is genuine, and the laboratory's check link is returned instead.

check_report

Returns the address of the laboratory's own report-check page, after checking that the number has that laboratory's format.

  • Required: lab (GIA or IGI) and report_number.
  • The link is only built. The report itself is the authority.

vyka_score

Returns VYKA's 0 to 100 score, its tier, its strengths and trade-offs, and how many figures were used.

  • Give either code for a listed stone, or type, shape, carat, colour and clarity for a stone you describe.
  • Optional with specifications: cut, polish, symmetry, fluorescence, lab, eye_clean, table_percent, depth_percent, length_mm, width_mm, crown_angle, pavilion_angle.
  • Natural and lab-grown diamonds are scored on separate scales that do not compare. Only white diamonds in the ten main shapes are scored. The fewer figures given, the less certain the score.

talk_to_jeweller

Returns a WhatsApp link to VYKA's sales line with a pre-written first message. It is meant for when you ask to contact VYKA.

  • Optional: stone (report number or VYK code) or product_url (a product page on vykadiamonds.com), and language (en or ar).
  • Nothing is sent. You open the link, can edit the message and send it yourself.

Examples

  1. "Find 1 carat oval lab-grown diamonds, colour F or better, clarity VS1 or better." Uses search_diamonds. Returns up to 10 listed stones with grades, laboratory, report number, AED price and page link.
  2. "Look up the first of those by its report number and tell me its measurements." Uses get_diamond. Returns the stone's details, or says it is no longer listed.
  3. "Where can I verify IGI report LG841660341 myself?" Uses check_report. Returns IGI's own page for that number, and notes that LG numbers are normally for lab-grown diamonds.
  4. "What VYKA Score would a 1.5 carat round natural diamond get at colour G, clarity VS2?" Uses vyka_score. Returns a score and tier, how few figures were used, and a link to the method.
  5. "I'd like to talk to a VYKA jeweller on WhatsApp about that diamond." Uses talk_to_jeweller. Returns a link that you open and send yourself.
  6. «ألماسة بيضاوية مختبرية بوزن قيراط واحد، بلون F أو أعلى ونقاء VS1 أو أعلى» Prompts can be in Arabic. Uses search_diamonds.

Limits

  • At most 10 stones per search. Only stones with a laboratory report are returned (natural: GIA, IGI or HRD; lab-grown: also GCAL).
  • Ring settings, finished rings, gemstones and coloured diamonds are not covered.
  • It cannot reserve or buy a stone, change a listing, or see orders or customers. Buying happens on the stone's page on vykadiamonds.com.
  • Stock changes quickly and a listed stone can sell at any time, so check a stone again before relying on it.
  • The AED price is the price charged. Amounts in other currencies are indicative and rounded up. Checkout is in AED.
  • Shipping is free worldwide. UAE prices include 5% VAT.
  • Duty and tax depend on the delivery address. For delivery in the GCC (UAE, Saudi Arabia, Qatar, Bahrain, Oman, Kuwait), the price includes VAT and customs duty. Outside the GCC, import duty and taxes are not included: the buyer pays them on delivery, or asks VYKA before ordering to add them to the price.
  • Requests are rate limited to keep the service available. If you hit the limit, the tool says so; try again in a minute.
  • Nothing here is a valuation or an appraisal.

Troubleshooting

  • The connector will not connect. Check that the address is exact and ends in /mcp, and that no sign-in or key is set.
  • "VYKA's diamond inventory did not answer in time." The stone feed was slow. Try again in a moment.
  • "No lab-grown diamonds in VYKA's diamond inventory match these filters right now." (or natural) Widen the carat, colour, clarity or budget, or ask for another shape.
  • "VYKA does not list a stone with number ... now." The stone may have sold, or VYKA may never have listed it. Use the laboratory's check link to read the report itself.
  • "Too many requests just now." Wait a minute and try again.
  • The assistant shows a picture from the web. Assistants can add web images by themselves, and those show other stones. A stone's real photo is on its page link.
  • A stone has sold since you saw it. Search again, or ask for it to be re-checked with its report number.

Privacy

This section covers the connector in any assistant. Our Privacy Policy covers everything else, including anything you send us after following a link.

What the connector receives

Only what the assistant sends to a tool: search details such as shape, carat, colour, clarity, budget and currency, a report number or VYKA code, a product page address, or a language. The tools do not ask for your name, email or phone number, and the connector has no access to your chat history. An assistant may also send an anonymous user identifier; it is used in memory for rate limiting and is not logged.

How it is used

To answer the request, and to keep the service secure and running (rate limiting and troubleshooting).

Who else handles it

  • Cloudflare hosts the server and processes every request, including the connecting IP address. With a hosted assistant, that is normally the assistant provider's address. A desktop tool that connects directly may show yours.
  • The supplier. To answer a search or a look-up, VYKA's website server sends the search details or the report number to the supplier's feed. Our code does not add anything that identifies you.
  • The assistant you use handles your chats under its own privacy policy.

We do not sell this information.

What we keep, and for how long

One log line per tool call: the time to the minute, the tool, coarse inputs (kinds and ranges, never report numbers, links or free text) and whether it worked. Our code does not write IP addresses or user identifiers to these logs. They are kept for up to 7 days and are processed by Cloudflare.

Your choices

You can turn the connector off or remove it at any time in your assistant. For questions about this section, write to sales@vykadiamonds.com.

Support