diamond-mcp

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.

{
  "type": "object",
  "properties": {
    "stones": {
      "type": "array",
      "minItems": 2,
      "maxItems": 5,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "label"
        ],
        "properties": {
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "carat": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 100
          },
          "length_mm": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 100
          },
          "width_mm": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 100
          },
          "price": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 100000000
          },
          "currency": {
            "type": "string",
            "pattern": "^[A-Z]{3}$"
          }
        }
      }
    }
  },
  "required": [
    "stones"
  ],
  "additionalProperties": false
}

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.

{
  "type": "object",
  "properties": {
    "lab": {
      "type": "string",
      "description": "The grading lab that issued the report: GIA, IGI, or GCAL. Case insensitive."
    },
    "report_number": {
      "type": "string",
      "description": "The report number printed on the grading report."
    }
  },
  "required": [
    "lab",
    "report_number"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "shape": {
      "type": "string",
      "description": "One of: round, oval, emerald, dutch_marquise. Case insensitive. Spaces and hyphens are accepted."
    },
    "carat": {
      "type": "number",
      "description": "Carat weight greater than zero, for example 1.0 or 1.52."
    }
  },
  "required": [
    "shape",
    "carat"
  ]
}

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.

{
  "type": "object",
  "properties": {}
}

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.

{
  "type": "object",
  "properties": {}
}

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

{
  "type": "object",
  "properties": {}
}

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.

{
  "type": "object",
  "properties": {}
}

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.

{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "description": "The term to define, for example \"Dutch Marquise\" or \"bow-tie effect\". Case insensitive."
    }
  },
  "required": [
    "term"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords to search for, for example \"bow tie\" or \"lab grown durability\"."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return, 1 to 10. Default 5."
    }
  },
  "required": [
    "query"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What the shopper is looking for, in plain words."
    },
    "limit": {
      "type": "integer",
      "description": "Max results (default 5, max 10).",
      "minimum": 1,
      "maximum": 10
    }
  },
  "required": [
    "query"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Exact id returned by search_inventory: a Shopify product gid or stienhardt:diamond:SKU."
    }
  },
  "required": [
    "id"
  ]
}