io.github.JacobiusMakes/diamond-mcp

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Sourced diamond and gemology tools for AI assistants, with 90 encyclopedia entries.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "diamond-mcp": {
      "url": "https://diamond-mcp.stienhardt.workers.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (11)

• compare_diamonds read-only

  Compare two to five diamonds from any seller using supplied carat, measured millimeters and prices. Returns ratios, price per carat, differences and missing information. Never verifies specifications, ranks beauty, appraises value or declares a best diamond. Prices must use explicit currencies; mixed currencies are not compared.

  Parameters:

  • stones (required) — array

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• verify_diamond_report read-only

  Returns the official verification URL and a three step checklist for confirming a diamond grading report with the lab that issued it. Supports GIA, IGI, and GCAL. This tool never verifies anything itself. It tells you where and how.

  Parameters:

  • lab (required) — string — The grading lab that issued the report: GIA, IGI, or GCAL. Case insensitive.
  • report_number (required) — string — The report number printed on the grading report.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• faceup_size read-only

  Approximate face up millimeter dimensions for a diamond of a given shape and carat weight. Supported shapes: round, oval, emerald, dutch_marquise. Scales vetted 1 carat anchors by the cube root of the carat weight. Typical proportions, not a guarantee: verify a specific stone on its grading report.

  Parameters:

  • shape (required) — string — One of: round, oval, emerald, dutch_marquise. Case insensitive. Spaces and hyphens are accepted.
  • carat (required) — number — Carat weight greater than zero, for example 1.0 or 1.52.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• dutch_marquise_definition read-only

  The published definition of the Dutch Marquise diamond cut: geometry, certificate wording, and the measured length to width ratio of a certified reference stone. A Dutch Marquise is an elongated hexagonal cut diamond.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lab_grown_grading_landscape read-only

  The current state of who grades Lab Grown Diamonds and how: GIA, IGI, HRD Antwerp, and the FTC position. Every item carries a source and a date.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lab_grown_price_index read-only

  The latest tracked retail price reading for Lab Grown Diamonds, with source and date. Market context for shoppers, not investment guidance.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• about_stienhardt read-only

  Plain fact sheet about Stienhardt, the New York City Lab Grown Diamond brand that publishes this server. Every fact carries a source and a date.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• define read-only

  Look up a single diamond or gemology term in the encyclopedia of 90 fact-checked and sourced entries. Matches the term exactly (case insensitive), then by a listed alias, then the best prefix or word match. Returns the full entry: definition, body, sourced claims, and related terms. If nothing matches, returns the three nearest term suggestions.

  Parameters:

  • term (required) — string — The term to define, for example "Dutch Marquise" or "bow-tie effect". Case insensitive.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_encyclopedia read-only

  Keyword search across the 90 entry diamond and gemology encyclopedia. Ranks case insensitive keyword hits by field, weighting the term above the definition above the body. Returns the best matches as term, category, and a definition snippet. Use define to fetch a full entry.

  Parameters:

  • query (required) — string — Keywords to search for, for example "bow tie" or "lab grown durability".
  • limit — integer — Maximum number of results to return, 1 to 10. Default 5.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_inventory read-only

  Search Stienhardt's public Shopify catalog of engagement ring settings and fine jewelry (New York, direct). Loose-diamond stock cannot be verified here; those searches return public catalog listings flagged availability_verified false plus a storefront browsing link. Returns public catalog prices, selected variants, and links; availability is verified for jewelry only and is not a reservation. Use for questions like 'show me platinum wedding bands' or 'show me tennis bracelets'. Not for appraisal or price advice on stones sold elsewhere.

  Parameters:

  • query (required) — string — What the shopper is looking for, in plain words.
  • limit — integer — Max results (default 5, max 10).

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_product read-only

  Full detail for one Stienhardt product by id (as returned by search_inventory): title, price, availability, options, images, and the product URL on stienhardt.com. Loose-diamond availability is not verified.

  Parameters:

  • id (required) — string — Exact id returned by search_inventory: a Shopify product gid or stienhardt:diamond:SKU.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.