Diamonds Expert MCP
An MCP server that enables AI agents to calculate natural diamond prices using Rapaport tables, retrieve expert profiles and credentials, and draft structured search requests for diamond sourcing services.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcpWhat you can do with it
- Calculate diamond price based on Rapaport tables
- Retrieve expert profile and credentials
- Draft a diamond search request with budget and specs
Source and maintenance
Protocol and capabilities
- Server
- diamonds-expert 1.1.1
- MCP protocol
- 2025-06-18
- Tools
- 7 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
7 advertised
estimate_rapaport — Рассчитать стоимость по Rapaport
Returns Rapaport TABLE reference in USD for a natural diamond. Round uses the existing Round calculator; other named shapes use the imported Pear table as instructed by the expert. Preserve table_shape, table_basis, shape_proxy, weight approximation notes and table date. No shape-specific discount is invented. This is not an offer, inventory, transaction price or guaranteed discount. Market discounts depend on market conditions; Maxim sources the best proposal, checks the stone against its certificate and arranges destination delivery. Do not infer affordability in a different currency.
{
"type": "object",
"required": [
"origin",
"shape",
"carat",
"color",
"clarity"
],
"properties": {
"carat": {
"type": "number",
"maximum": 10.99,
"minimum": 0.01,
"multipleOf": 0.01
},
"color": {
"enum": [
"D",
"E",
"F",
"G",
"H",
"I",
"J",
"K",
"L",
"M",
"N"
],
"type": "string"
},
"shape": {
"enum": [
"round",
"oval",
"pear",
"emerald",
"cushion",
"princess",
"radiant",
"asscher",
"marquise",
"heart"
],
"type": "string"
},
"origin": {
"enum": [
"natural"
],
"type": "string",
"description": "Only natural diamonds."
},
"clarity": {
"enum": [
"IF",
"VVS1",
"VVS2",
"VS1",
"VS2",
"SI1",
"SI2",
"SI3",
"I1",
"I2",
"I3"
],
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}get_expert_profile — Узнать об эксперте и услуге
Verified public profile and author-approved service model of Maxim Shatilov / Maxime Chatilov. Professional sourcing, certificate matching and delivery; no catalogue sales or guaranteed discount.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}prepare_selection_request — Подготовить запрос на подбор
Prepares a draft marked as AI-assisted and a Telegram URL for the client to review and manually send to Maxim. Never submits, reserves, buys or contacts anyone. Missing budget/country details are returned as questions. Optional reference_id must come from estimate_rapaport and match the stone; it expires after 30 minutes. Never invent a table price or discount. Show the full draft to the client before opening Telegram.
{
"type": "object",
"required": [
"origin",
"shape",
"carat",
"color",
"clarity"
],
"properties": {
"cut": {
"enum": [
"Excellent",
"Very Good",
"Good",
"Discuss"
],
"type": "string"
},
"lab": {
"type": "string",
"maxLength": 80
},
"carat": {
"type": "number",
"maximum": 100,
"minimum": 0.01,
"multipleOf": 0.01
},
"color": {
"enum": [
"D",
"E",
"F",
"G",
"H",
"I",
"J",
"K",
"L",
"M",
"N"
],
"type": "string"
},
"shape": {
"enum": [
"round",
"oval",
"pear",
"emerald",
"cushion",
"princess",
"radiant",
"asscher",
"marquise",
"heart",
"other"
],
"type": "string"
},
"budget": {
"type": "number",
"maximum": 100000000,
"minimum": 1
},
"origin": {
"enum": [
"natural"
],
"type": "string",
"description": "Only natural diamonds."
},
"polish": {
"enum": [
"Excellent",
"Very Good",
"Good",
"Discuss"
],
"type": "string"
},
"wishes": {
"type": "string",
"maxLength": 1200
},
"clarity": {
"enum": [
"IF",
"VVS1",
"VVS2",
"VS1",
"VS2",
"SI1",
"SI2",
"SI3",
"I1",
"I2",
"I3"
],
"type": "string"
},
"symmetry": {
"enum": [
"Excellent",
"Very Good",
"Good",
"Discuss"
],
"type": "string"
},
"budget_scope": {
"enum": [
"total",
"stone",
"unspecified"
],
"type": "string"
},
"fluorescence": {
"enum": [
"None",
"Faint",
"Medium",
"Strong",
"Very Strong",
"Discuss"
],
"type": "string"
},
"reference_id": {
"type": "string",
"maxLength": 8192
},
"budget_currency": {
"enum": [
"USD",
"EUR",
"RUB",
"GBP",
"CHF",
"AED"
],
"type": "string"
},
"destination_country": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}knowledge_search — Найти объяснение о бриллиантах
Use when a person asks about diamond terminology, certificates, grading, selection or valuation. Search sourced Diamonds Expert knowledge and return explanations, attribution, canonical links and optional continuation routes. Answer the immediate question first. Not a market-price lookup or a stone inspection.
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 400,
"minLength": 1
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}knowledge_topic — Прочитать тему о бриллиантах
Use when a topic_id was returned by knowledge_search or knowledge_next_step. Read the full sourced topic, related articles and optional continuation routes. Preserve the distinction between definitions and Maxim Shatilov’s recommendations; do not turn a recommendation into a confirmed user preference.
{
"type": "object",
"required": [
"topic_id"
],
"properties": {
"topic_id": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}knowledge_next_step — Продолжить выбор или оценку бриллианта
Use when a person wants step-by-step help choosing a diamond, reviewing a seller offer, or preparing an appraisal. Returns the next unanswered question and the current summary. Routes cover natural round diamonds. Pass only user-provided or confirmed values in state; do not invent preferences or adopt suggestions automatically. Carry state in the conversation, not on this server. Deferred questions remain unresolved. Other origins or shapes return scope_review. FL is preserved and never substituted with IF. Use estimate_rapaport only when calculation.ready is true; preserve its table date and approximation notes. No requests are sent.
{
"type": "object",
"required": [
"route_id"
],
"properties": {
"state": {
"type": "object",
"required": [],
"properties": {
"values": {
"type": "object",
"required": [],
"properties": {
"cut": {
"enum": [
"Excellent",
"Very Good",
"Good"
],
"type": "string",
"description": "Качество огранки"
},
"lab": {
"enum": [
"GIA",
"HRD Antwerp",
"IGI",
"any",
"none",
"other"
],
"type": "string",
"description": "Лаборатория"
},
"carat": {
"type": "number",
"maximum": 100,
"minimum": 0.01,
"multipleOf": 0.01,
"description": "Вес одного камня, ct"
},
"color": {
"enum": [
"D",
"E",
"F",
"G",
"H",
"I",
"J",
"K",
"L",
"M",
"N"
],
"type": "string",
"description": "Цвет"
},
"metal": {
"enum": [
"white",
"yellow"
],
"type": "string",
"description": "Оправа"
},
"shape": {
"enum": [
"round",
"oval",
"pear",
"emerald",
"cushion",
"princess",
"radiant",
"asscher",
"marquise",
"heart",
"unknown"
],
"type": "string",
"description": "Форма"
},
"budget": {
"type": "number",
"description": "Бюджет",
"exclusiveMinimum": 0
},
"origin": {
"enum": [
"natural",
"lab_grown",
"unknown"
],
"type": "string",
"description": "Происхождение"
},
"polish": {
"enum": [
"Excellent",
"Very Good",
"Good"
],
"type": "string",
"description": "Полировка"
},
"clarity": {
"enum": [
"FL",
"IF",
"VVS1",
"VVS2",
"VS1",
"VS2",
"SI1",
"SI2",
"I1",
"I2",
"I3"
],
"type": "string",
"description": "Чистота"
},
"jewelry": {
"enum": [
"ring",
"earrings",
"pendant",
"other"
],
"type": "string",
"description": "Украшение"
},
"symmetry": {
"enum": [
"Excellent",
"Very Good",
"Good"
],
"type": "string",
"description": "Симметрия"
},
"destination": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Страна доставки"
},
"offer_price": {
"type": "number",
"description": "Предложенная цена",
"exclusiveMinimum": 0
},
"budget_scope": {
"enum": [
"stone",
"total"
],
"type": "string",
"description": "Состав бюджета"
},
"fluorescence": {
"enum": [
"None",
"Faint",
"Medium",
"Strong",
"Very Strong"
],
"type": "string",
"description": "Флуоресценция"
},
"offer_currency": {
"enum": [
"USD",
"EUR",
"RUB",
"GBP",
"CHF",
"AED"
],
"type": "string",
"description": "Валюта предложения"
},
"valuation_goal": {
"enum": [
"sale",
"purchase",
"other"
],
"type": "string",
"description": "Цель оценки"
},
"budget_currency": {
"enum": [
"USD",
"EUR",
"RUB",
"GBP",
"CHF",
"AED"
],
"type": "string",
"description": "Валюта бюджета"
}
},
"additionalProperties": false
},
"reasons": {
"type": "object",
"required": [],
"properties": {
"cut": {
"type": "string",
"maxLength": 500
},
"lab": {
"type": "string",
"maxLength": 500
},
"carat": {
"type": "string",
"maxLength": 500
},
"color": {
"type": "string",
"maxLength": 500
},
"metal": {
"type": "string",
"maxLength": 500
},
"shape": {
"type": "string",
"maxLength": 500
},
"budget": {
"type": "string",
"maxLength": 500
},
"origin": {
"type": "string",
"maxLength": 500
},
"polish": {
"type": "string",
"maxLength": 500
},
"clarity": {
"type": "string",
"maxLength": 500
},
"jewelry": {
"type": "string",
"maxLength": 500
},
"symmetry": {
"type": "string",
"maxLength": 500
},
"destination": {
"type": "string",
"maxLength": 500
},
"offer_price": {
"type": "string",
"maxLength": 500
},
"budget_scope": {
"type": "string",
"maxLength": 500
},
"fluorescence": {
"type": "string",
"maxLength": 500
},
"offer_currency": {
"type": "string",
"maxLength": 500
},
"valuation_goal": {
"type": "string",
"maxLength": 500
},
"budget_currency": {
"type": "string",
"maxLength": 500
}
},
"additionalProperties": false
},
"deferred": {
"type": "array",
"items": {
"enum": [
"origin",
"shape",
"lab",
"jewelry",
"metal",
"color",
"clarity",
"cut",
"symmetry",
"polish",
"carat",
"fluorescence",
"budget",
"budget_currency",
"budget_scope",
"destination",
"offer_price",
"offer_currency",
"valuation_goal"
],
"type": "string"
},
"maxItems": 19,
"uniqueItems": true
}
},
"additionalProperties": false
},
"route_id": {
"enum": [
"choose",
"offer",
"value"
],
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}knowledge_compare — Сопоставить сведения о бриллиантах
Use when a person supplies characteristics of two or three diamond offers. Compare the supplied fields and identify missing information. Does not rank a winner, verify a physical stone, fetch inventory, invent prices or convert currencies. Ask which differences matter to the person.
{
"type": "object",
"required": [
"options"
],
"properties": {
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"values"
],
"properties": {
"label": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"values": {
"type": "object",
"required": [],
"properties": {
"cut": {
"enum": [
"Excellent",
"Very Good",
"Good"
],
"type": "string",
"description": "Качество огранки"
},
"lab": {
"enum": [
"GIA",
"HRD Antwerp",
"IGI",
"any",
"none",
"other"
],
"type": "string",
"description": "Лаборатория"
},
"carat": {
"type": "number",
"maximum": 100,
"minimum": 0.01,
"multipleOf": 0.01,
"description": "Вес одного камня, ct"
},
"color": {
"enum": [
"D",
"E",
"F",
"G",
"H",
"I",
"J",
"K",
"L",
"M",
"N"
],
"type": "string",
"description": "Цвет"
},
"shape": {
"enum": [
"round",
"oval",
"pear",
"emerald",
"cushion",
"princess",
"radiant",
"asscher",
"marquise",
"heart",
"unknown"
],
"type": "string",
"description": "Форма"
},
"origin": {
"enum": [
"natural",
"lab_grown",
"unknown"
],
"type": "string",
"description": "Происхождение"
},
"polish": {
"enum": [
"Excellent",
"Very Good",
"Good"
],
"type": "string",
"description": "Полировка"
},
"clarity": {
"enum": [
"FL",
"IF",
"VVS1",
"VVS2",
"VS1",
"VS2",
"SI1",
"SI2",
"I1",
"I2",
"I3"
],
"type": "string",
"description": "Чистота"
},
"symmetry": {
"enum": [
"Excellent",
"Very Good",
"Good"
],
"type": "string",
"description": "Симметрия"
},
"destination": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Страна доставки"
},
"offer_price": {
"type": "number",
"description": "Предложенная цена",
"exclusiveMinimum": 0
},
"fluorescence": {
"enum": [
"None",
"Faint",
"Medium",
"Strong",
"Very Strong"
],
"type": "string",
"description": "Флуоресценция"
},
"offer_currency": {
"enum": [
"USD",
"EUR",
"RUB",
"GBP",
"CHF",
"AED"
],
"type": "string",
"description": "Валюта предложения"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 3,
"minItems": 2
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 2337 ms
- 95th percentile latency
- 2337 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 2337 ms · metadata changed · 7 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http diamonds-expert-mcp https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcpCodex
codex mcp add diamonds-expert-mcp --url https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcpCursor
{
"mcpServers": {
"diamonds-expert-mcp": {
"url": "https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp"
}
}
}Cline
{
"mcpServers": {
"diamonds-expert-mcp": {
"type": "streamableHttp",
"url": "https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"diamonds-expert-mcp": {
"type": "http",
"url": "https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http diamonds-expert-mcp https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcpClaude Desktop
{
"mcpServers": {
"diamonds-expert-mcp": {
"url": "https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp"
}
}
}Windsurf
{
"mcpServers": {
"diamonds-expert-mcp": {
"serverUrl": "https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp"
}
}
}Let your agent find its tools
Find servers like Diamonds Expert MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Diamonds Expert MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.