Server definition
- Hash
- sha256:1084234b886e9d3717548216bf608ad68e1c5c0142f5c0f66077b44446bb1f9a
- What it is
- What a remote MCP server returned when asked what it offers: 8 tools
The blob, as servednamed by its sha256
{
"instructions": "25karats is a family-owned New York jewelry manufacturer: 1,500+ made-to-order wedding band designs, engagement rings, his & hers sets, and IGI-certified lab-grown diamonds, handcrafted in the USA with free shipping, free engraving, 60-day returns, and a lifetime warranty. Every ring is customizable (metal, ring size, width, thickness, color, finish, engraving) and priced live from current metal markets. Typical flow: search_products or browse_collection to find candidates, get_product for options and ids, price_product for the exact configured price plus a pre-configured checkout link, get_product_images for high-resolution photos, search_diamonds for loose center stones, and get_store_info for policies. All prices are USD.",
"tools": [
{
"description": "Browse one collection/category page deterministically — the same product set, ordering, and filters a shopper sees on the site. Pass the collection permalink from list_collections (e.g. 'wedding-rings/womens/eternity'). Filter by style tags, metals, or sort; paginate 24 per page. Prefer search_products for free-text intent and this tool for \"show me everything in X\".",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cats": {
"description": "Child-category slugs on a listing-nav collection; matches the site's cats filter",
"items": {
"type": "string"
},
"type": "array"
},
"collection": {
"description": "Collection permalink, with or without leading slash",
"type": "string"
},
"limit": {
"description": "Max 24",
"type": "integer"
},
"metals": {
"description": "Offered metal codes, e.g. ['14K','PLAT']; price and URL use the first offered selection",
"items": {
"type": "string"
},
"type": [
"string",
"array"
]
},
"page": {
"type": "integer"
},
"price_tag": {
"description": "Price-range slug or id, e.g. '501-1000'; accepts one value or an array",
"items": {
"type": [
"string",
"integer"
]
},
"type": [
"string",
"integer",
"array"
]
},
"sort": {
"description": "Default: best sellers",
"enum": [
"best",
"price_asc",
"price_desc"
],
"type": "string"
},
"tags": {
"description": "Style tag slugs, e.g. ['celtic','braided']",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"collection"
],
"type": "object"
},
"name": "browse_collection",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"applied_filters": {
"type": "object"
},
"child_collections": {
"items": {
"properties": {
"children": {
"items": {
"type": "object"
},
"type": "array"
},
"description": {
"type": "string"
},
"permalink": {
"type": "string"
},
"product_count": {
"minimum": 0,
"type": "integer"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"permalink",
"url"
],
"type": "object"
},
"type": "array"
},
"collection": {
"properties": {
"children": {
"items": {
"type": "object"
},
"type": "array"
},
"description": {
"type": "string"
},
"permalink": {
"type": "string"
},
"product_count": {
"minimum": 0,
"type": "integer"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"permalink",
"url"
],
"type": "object"
},
"note": {
"type": "string"
},
"page": {
"minimum": 1,
"type": "integer"
},
"per_page": {
"maximum": 24,
"minimum": 1,
"type": "integer"
},
"products": {
"items": {
"properties": {
"currency": {
"const": "USD",
"type": "string"
},
"image_url": {
"format": "uri",
"type": "string"
},
"metal_codes": {
"items": {
"enum": [
"10K",
"14K",
"18K",
"PLAT",
"SILVER",
"STEEL",
"TITANIUM",
"COBALT",
"TUNGSTEN",
"CERAMIC"
],
"type": "string"
},
"type": "array"
},
"metals": {
"items": {
"type": "string"
},
"type": "array"
},
"product_line": {
"type": "string"
},
"starting_price": {
"type": "number"
},
"style_code": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"style_code",
"title",
"product_line",
"url",
"currency",
"metals",
"metal_codes",
"tags"
],
"type": "object"
},
"type": "array"
},
"total_count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"collection"
],
"type": "object"
}
},
{
"description": "Full detail for one product: metal variants with live starting prices, the complete customization matrix (ring sizes, widths, thickness, color, finish, stone type, engraving rules) with the ids to echo into price_product, stone specifications, physical dimensions, size-group siblings, matching pieces, and the default image. Identify the product by exactly one of slug, style_code, or url (any 25karats product URL works).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"metal": {
"description": "Optionally preselect a metal variant",
"enum": [
"10K",
"14K",
"18K",
"PLAT",
"SILVER",
"STEEL",
"TITANIUM",
"COBALT",
"TUNGSTEN",
"CERAMIC"
],
"type": "string"
},
"slug": {
"description": "Product page slug, e.g. 'floral-antique-handmade-wedding-ring'",
"type": "string"
},
"style_code": {
"description": "Style/SKU code shown on the product page, e.g. 'HC100232'",
"type": "string"
},
"url": {
"description": "Any 25karats.com product URL",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_product",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"availability": {
"const": "made_to_order",
"type": "string"
},
"brand": {
"type": "string"
},
"breadcrumb": {
"items": {
"properties": {
"children": {
"items": {
"type": "object"
},
"type": "array"
},
"description": {
"type": "string"
},
"permalink": {
"type": "string"
},
"product_count": {
"minimum": 0,
"type": "integer"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"permalink",
"url"
],
"type": "object"
},
"type": "array"
},
"currency": {
"const": "USD",
"type": "string"
},
"customization": {
"type": "object"
},
"default_image": {
"type": "object"
},
"description": {
"type": "string"
},
"faq": {
"items": {
"type": "object"
},
"type": "array"
},
"image_count": {
"minimum": 0,
"type": "integer"
},
"lead_time": {
"type": "string"
},
"matching_product": {
"type": "object"
},
"physical_details": {
"type": "object"
},
"pricing_note": {
"type": "string"
},
"product_line": {
"type": "string"
},
"size_group_siblings": {
"type": "object"
},
"stones": {
"type": "object"
},
"style_code": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"variants": {
"items": {
"properties": {
"metal": {
"description": "Customer-facing metal name",
"type": "string"
},
"metal_code": {
"enum": [
"10K",
"14K",
"18K",
"PLAT",
"SILVER",
"STEEL",
"TITANIUM",
"COBALT",
"TUNGSTEN",
"CERAMIC"
],
"type": "string"
},
"selected": {
"type": "boolean"
},
"starting_price": {
"type": "number"
},
"style_code": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"variant_id": {
"type": "integer"
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"style_code",
"title",
"product_line",
"url",
"brand",
"currency",
"availability",
"lead_time",
"breadcrumb",
"tags",
"variants",
"customization",
"image_count",
"pricing_note"
],
"type": "object"
}
},
{
"description": "Every gallery image for a product with high-resolution URLs. Each image lists only renditions that actually exist, largest first — modern photography is 2048x2048 WebP at the 'original' size — plus the metal tone, band width, and finish the photo shows, and descriptive alt text. Identify the product by exactly one of slug, style_code, or url.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"metal_tone": {
"description": "Optionally return only photos showing this metal tone",
"enum": [
"White",
"Yellow",
"Rose",
"Two Tone"
],
"type": "string"
},
"slug": {
"type": "string"
},
"style_code": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_product_images",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"image_count": {
"minimum": 0,
"type": "integer"
},
"images": {
"items": {
"properties": {
"alt": {
"type": "string"
},
"finish": {
"type": "string"
},
"metal_tone": {
"enum": [
"White",
"Yellow",
"Rose",
"Two Tone"
],
"type": "string"
},
"role": {
"enum": [
"main",
"alternate"
],
"type": "string"
},
"sizes": {
"additionalProperties": {
"format": "uri",
"type": "string"
},
"type": "object"
},
"width": {
"type": [
"string",
"number"
]
}
},
"required": [
"role",
"alt",
"sizes"
],
"type": "object"
},
"type": "array"
},
"style_code": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"style_code",
"title",
"image_count",
"images"
],
"type": "object"
}
},
{
"description": "25karats brand facts and policies for answering shoppers: who we are, shipping and production times, returns, warranty, resizing, engraving, financing, and contact details. Call this before answering policy questions rather than guessing.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"required": [],
"type": "object"
},
"name": "get_store_info",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"brand": {
"type": "object"
},
"diamonds": {
"type": "string"
},
"engraving": {
"type": "string"
},
"key_pages": {
"type": "object"
},
"payments": {
"type": "string"
},
"production_and_shipping": {
"type": "object"
},
"resizing": {
"type": "string"
},
"returns": {
"type": "object"
},
"sales_tax": {
"type": "string"
},
"warranty": {
"type": "string"
}
},
"required": [
"brand",
"production_and_shipping",
"returns",
"warranty",
"resizing",
"engraving",
"diamonds",
"payments",
"sales_tax",
"key_pages"
],
"type": "object"
}
},
{
"description": "The navigable catalog taxonomy: every public collection with its permalink (for browse_collection), title, and product count, as a tree. Call once to orient; results change rarely.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"required": [],
"type": "object"
},
"name": "list_collections",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"collections": {
"items": {
"properties": {
"children": {
"items": {
"type": "object"
},
"type": "array"
},
"description": {
"type": "string"
},
"permalink": {
"type": "string"
},
"product_count": {
"minimum": 0,
"type": "integer"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"permalink",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"collections"
],
"type": "object"
}
},
{
"description": "Exact live price in USD for a fully configured item — the same number the customer pays on 25karats.com (computed from current metal market pricing, not a cached feed price). Identify the item by variant_id (from get_product) or style_code, optionally with metal. For wedding bands pass ring_size/width/thickness/color/finish (option_value ids or display values from get_product); for his & hers sets pass his/her objects with those keys; for engagement rings pass stone_type and ring_size. Unset axes use the product's defaults. Returns the price, the resolved configuration, and a deep_link_url that opens the product page pre-configured for checkout. Invalid values return the list of valid ones — correct and retry. Any option group can also be set through the options object keyed by the option_id values returned by get_product (the only way to configure generic jewelry). His & hers options and engraving belong inside the respective his/her object. Inputs that do not apply to the item (stone_type on a band, top-level ring_size on a set) are rejected with the inputs that do; settings sold without a center stone say so in configuration and notes.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"color": {
"type": "string"
},
"engraving_font": {
"description": "Wedding bands only; for H&H put this inside his/her",
"type": "string"
},
"engraving_text": {
"description": "Wedding bands only; for H&H put this inside his/her",
"type": "string"
},
"finish": {
"type": "string"
},
"her": {
"description": "His & hers sets: configuration and optional engraving for the her band",
"properties": {
"color": {
"type": "string"
},
"engraving_font": {
"type": "string"
},
"engraving_text": {
"type": "string"
},
"finish": {
"type": "string"
},
"options": {
"additionalProperties": {
"type": [
"string",
"integer",
"number"
]
},
"description": "Map option_id (from get_product) to an option_value id or display label; an alternative to the named axes for any customizable item",
"type": "object"
},
"ring_size": {
"type": "string"
},
"thickness": {
"type": "string"
},
"width": {
"type": "string"
}
},
"type": "object"
},
"his": {
"description": "His & hers sets: configuration and optional engraving for the his band",
"properties": {
"color": {
"type": "string"
},
"engraving_font": {
"type": "string"
},
"engraving_text": {
"type": "string"
},
"finish": {
"type": "string"
},
"options": {
"additionalProperties": {
"type": [
"string",
"integer",
"number"
]
},
"description": "Map option_id (from get_product) to an option_value id or display label; an alternative to the named axes for any customizable item",
"type": "object"
},
"ring_size": {
"type": "string"
},
"thickness": {
"type": "string"
},
"width": {
"type": "string"
}
},
"type": "object"
},
"metal": {
"enum": [
"10K",
"14K",
"18K",
"PLAT",
"SILVER",
"STEEL",
"TITANIUM",
"COBALT",
"TUNGSTEN",
"CERAMIC"
],
"type": "string"
},
"options": {
"additionalProperties": {
"type": [
"string",
"integer",
"number"
]
},
"description": "Map option_id (from get_product) to an option_value id or display label; an alternative to the named axes for any customizable item",
"type": "object"
},
"ring_size": {
"type": "string"
},
"slug": {
"type": "string"
},
"stone_type": {
"description": "Engagement rings with a diamond-type choice: 'natural' or 'lab' (or the id from get_product). Rejected on settings sold without a center stone (get_product shows stone_types: [] and setting_only: true)",
"type": "string"
},
"style_code": {
"type": "string"
},
"thickness": {
"type": "string"
},
"url": {
"type": "string"
},
"variant_id": {
"description": "Variant id from get_product (preferred)",
"type": "integer"
},
"width": {
"description": "Bands: option_value id or display value, e.g. '6' (mm)",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "price_product",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"availability": {
"const": "made_to_order",
"type": "string"
},
"configuration": {
"items": {
"type": "object"
},
"type": "array"
},
"currency": {
"const": "USD",
"type": "string"
},
"deep_link_url": {
"format": "uri",
"type": "string"
},
"lead_time": {
"type": "string"
},
"metal": {
"description": "Customer-facing metal name",
"type": "string"
},
"metal_code": {
"enum": [
"10K",
"14K",
"18K",
"PLAT",
"SILVER",
"STEEL",
"TITANIUM",
"COBALT",
"TUNGSTEN",
"CERAMIC"
],
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"minimum": 0,
"type": "number"
},
"price_as_of": {
"type": "string"
},
"style_code": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"style_code",
"title",
"metal",
"metal_code",
"price",
"currency",
"price_as_of",
"availability",
"lead_time",
"configuration",
"deep_link_url",
"notes"
],
"type": "object"
}
},
{
"description": "Search 25karats' in-stock IGI/GIA-certified lab-grown loose diamonds (center stones for engagement rings) by shape, carat, color, clarity, cut, and price. Prices are the live customer price in USD. Each stone includes certificate details, measurements, and image/video links when available. A chosen stone is paired with a ring setting on-site.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"carat_max": {
"type": "number"
},
"carat_min": {
"type": "number"
},
"clarity": {
"description": "One clarity or an array, e.g. 'VS1' or ['VS1','VVS2']",
"items": {
"type": "string"
},
"type": [
"string",
"array"
]
},
"color": {
"description": "One color or an array; D through K",
"items": {
"type": "string"
},
"type": [
"string",
"array"
]
},
"cut": {
"description": "Cut grade as a label or certificate code: 'Ideal' (ID) or 'Excellent' (EX)",
"type": "string"
},
"lab": {
"description": "Grading lab, e.g. IGI or GIA",
"type": "string"
},
"limit": {
"description": "Max 50",
"type": "integer"
},
"page": {
"type": "integer"
},
"polish": {
"description": "Polish grade as a label or certificate code: 'Excellent' (EX), 'Very Good' (VG), 'Good' (GD)",
"type": "string"
},
"price_max": {
"type": "number"
},
"price_min": {
"type": "number"
},
"shape": {
"description": "One shape or an array, e.g. 'Round' or ['Oval','Emerald']",
"items": {
"type": "string"
},
"type": [
"string",
"array"
]
},
"sort": {
"enum": [
"price_asc",
"price_desc",
"carat_asc",
"carat_desc",
"recent"
],
"type": "string"
},
"stock_no": {
"description": "Exact stone lookup by stock number",
"type": "string"
},
"symmetry": {
"description": "Symmetry grade as a label or certificate code: 'Excellent' (EX) or 'Very Good' (VG)",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "search_diamonds",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"browse_url": {
"format": "uri",
"type": "string"
},
"diamonds": {
"items": {
"properties": {
"carat": {
"type": "number"
},
"clarity": {
"type": "string"
},
"color": {
"type": "string"
},
"currency": {
"const": "USD",
"type": "string"
},
"price": {
"minimum": 0,
"type": "number"
},
"shape": {
"type": "string"
},
"stock_no": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"stock_no",
"shape",
"carat",
"color",
"clarity",
"price",
"currency",
"url"
],
"type": "object"
},
"type": "array"
},
"page": {
"minimum": 1,
"type": "integer"
},
"per_page": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"total_count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"total_count",
"page",
"per_page",
"diamonds",
"browse_url"
],
"type": "object"
}
},
{
"description": "Search the 25karats made-to-order catalog (wedding bands, engagement rings, his & hers sets, fine jewelry) by keywords or a style code. Use this first when a shopper describes what they want (\"braided mens wedding band\", \"vintage engagement ring\"). Returns product cards with live starting prices in USD, image URLs, and product URLs. Follow up with get_product for options and price_product for an exact configured price. total_count is exact unless capped is true; capped counts are lower bounds imposed by the search index.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"category": {
"description": "Optional shopper-facing catalog category. engagement_rings / wedding_bands / his_hers_sets / jewelry select a product line; mens_rings and womens_diamond_rings select the site's men's (/wedding-rings/mens) and women's (/wedding-rings/womens) ring collections, which hold plain bands and diamond rings alike",
"enum": [
"engagement_rings",
"wedding_bands",
"mens_rings",
"womens_diamond_rings",
"his_hers_sets",
"jewelry"
],
"type": "string"
},
"limit": {
"description": "Requested results per page (default 10); values outside 1..24 are clamped and reported",
"type": "integer"
},
"metal": {
"description": "Optional metal filter; each returned starting price and URL use this metal's variant",
"enum": [
"10K",
"14K",
"18K",
"PLAT",
"SILVER",
"STEEL",
"TITANIUM",
"COBALT",
"TUNGSTEN",
"CERAMIC"
],
"type": "string"
},
"page": {
"description": "Requested page; values below 1 are clamped and reported",
"type": "integer"
},
"price_max": {
"type": "number"
},
"price_min": {
"type": "number"
},
"product_line": {
"description": "Optional product-line filter; category is preferred",
"enum": [
"engagement_or_diamond_ring",
"wedding_band",
"his_and_hers_set",
"jewelry"
],
"type": "string"
},
"query": {
"description": "Keywords or a style code (e.g. 'HC100232')",
"type": "string"
},
"tags": {
"description": "Every supplied style tag must match, by slug, name, or id",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_products",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"applied_filters": {
"description": "Validated optional filters applied to this search",
"properties": {
"category": {
"type": "string"
},
"collection": {
"description": "Collection permalink a category was resolved to",
"type": "string"
},
"metal": {
"type": "string"
},
"price_basis": {
"description": "Catalog offer whose default configuration is used for price filtering",
"type": "string"
},
"price_max": {
"type": "number"
},
"price_min": {
"type": "number"
},
"product_line": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"capped": {
"description": "True when total_count reached the search index's reporting ceiling and is not exact",
"type": "boolean"
},
"has_more": {
"description": "True when another page exists within the reported result window",
"type": "boolean"
},
"page": {
"minimum": 1,
"type": "integer"
},
"pagination": {
"properties": {
"effective_limit": {
"maximum": 24,
"minimum": 1,
"type": "integer"
},
"effective_page": {
"minimum": 1,
"type": "integer"
},
"limit_clamped": {
"type": "boolean"
},
"page_clamped": {
"type": "boolean"
},
"requested_limit": {
"type": "integer"
},
"requested_page": {
"type": "integer"
}
},
"required": [
"requested_limit",
"effective_limit",
"limit_clamped",
"requested_page",
"effective_page",
"page_clamped"
],
"type": "object"
},
"per_page": {
"maximum": 24,
"minimum": 1,
"type": "integer"
},
"products": {
"items": {
"properties": {
"currency": {
"const": "USD",
"type": "string"
},
"image_url": {
"format": "uri",
"type": "string"
},
"metal_codes": {
"items": {
"enum": [
"10K",
"14K",
"18K",
"PLAT",
"SILVER",
"STEEL",
"TITANIUM",
"COBALT",
"TUNGSTEN",
"CERAMIC"
],
"type": "string"
},
"type": "array"
},
"metals": {
"items": {
"type": "string"
},
"type": "array"
},
"product_line": {
"type": "string"
},
"starting_price": {
"type": "number"
},
"style_code": {
"type": "string"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"style_code",
"title",
"product_line",
"url",
"currency",
"metals",
"metal_codes",
"tags"
],
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"total_count": {
"description": "Exact match count unless capped is true; then this is a lower bound",
"minimum": 0,
"type": "integer"
}
},
"required": [
"query",
"total_count",
"capped",
"has_more",
"applied_filters",
"pagination",
"page",
"per_page",
"products"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:1084234b886e9d3717548216bf608ad68e1c5c0142f5c0f66077b44446bb1f9a | sha256sum