Koskamo

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.

Diamonds Expert MCP logo, by Diamonds ExpertVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Diamonds Expert
MCP endpoint (Streamable HTTP)
https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp
Vendor documentation

What 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

Vendor evidenceRegistry 1.0.3

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
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Round table for round natural diamonds; Pear table for other named shapes. This is a table reference, not inventory or a transaction price. Preserve date, table basis, approximation notes and unknown costs. prepare_selection_request returns a draft and Telegram URL; show both to the client for review and manual sending. No order or message is submitted. Sourced knowledge tools answer diamond questions and optionally continue choose, offer or value routes. Answer the immediate question first; only continue when relevant to the user. Preserve source attribution, dates and links. Knowledge routes cover natural round diamonds. Carry state in the conversation using only user-provided or user-confirmed values; suggestions are not choices, deferred fields remain unresolved. Use estimate_rapaport for a live table reference; knowledge tools never create a price or submit a request.

Tools

7 advertised

estimate_rapaport — Рассчитать стоимость по Rapaport
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

estimate_rapaport input schema
{
  "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
}
estimate_rapaport annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
get_expert_profile — Узнать об эксперте и услуге
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_expert_profile input schema
{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}
get_expert_profile annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
prepare_selection_request — Подготовить запрос на подбор
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

prepare_selection_request input schema
{
  "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
}
prepare_selection_request annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
knowledge_search — Найти объяснение о бриллиантах
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

knowledge_search input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 400,
      "minLength": 1
    }
  },
  "additionalProperties": false
}
knowledge_search annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
knowledge_topic — Прочитать тему о бриллиантах
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

knowledge_topic input schema
{
  "type": "object",
  "required": [
    "topic_id"
  ],
  "properties": {
    "topic_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    }
  },
  "additionalProperties": false
}
knowledge_topic annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
knowledge_next_step — Продолжить выбор или оценку бриллианта
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

knowledge_next_step input schema
{
  "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
}
knowledge_next_step annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
knowledge_compare — Сопоставить сведения о бриллиантах
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

knowledge_compare input schema
{
  "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
}
knowledge_compare annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

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.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http diamonds-expert-mcp https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add diamonds-expert-mcp --url https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable diamonds-expert-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "diamonds-expert-mcp": {
      "url": "https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "diamonds-expert-mcp": {
      "type": "streamableHttp",
      "url": "https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start diamonds-expert-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "diamonds-expert-mcp": {
      "type": "http",
      "url": "https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http diamonds-expert-mcp https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "diamonds-expert-mcp": {
      "url": "https://diamonds-expert.com/wp-json/diamonds-agent/v1/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "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.

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.

Claim this listing