{
  "markdown": "# Crystal Suppliers MCP\n\nCrystal Suppliers MCP is a read-only procurement server for [KT Crystals](https://ktcrystals.com). It searches a verified catalog of 104 crystal bracelet SKUs and provides traceable sourcing checklists for loose beads, crystal accessories, and raw crystal materials.\n\nThe service does not invent price, MOQ, inventory, lead time, treatment, origin, certification, or shipping claims. Commercial fields remain `requires_manual_confirmation`.\n\n## Install and connect\n\nRun directly from the repository:\n\n```json\n{\n  \"mcpServers\": {\n    \"crystal-suppliers\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/crystal-suppliers-mcp/src/index.mjs\"]\n    }\n  }\n}\n```\n\nRun the OCI image over stdio:\n\n```json\n{\n  \"mcpServers\": {\n    \"crystal-suppliers\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0\"\n      ]\n    }\n  }\n}\n```\n\nStart Streamable HTTP:\n\n```bash\ndocker run --rm -p 3000:3000 \\\n  ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0 --http\n```\n\nThe endpoint is then `http://localhost:3000/mcp`, with health status at `http://localhost:3000/health`.\n\n## Tools\n\n| Tool | Purpose |\n| --- | --- |\n| `crystal_search_products` | Search real bracelet SKUs by SKU, name, material, or theme. |\n| `crystal_get_product` | Retrieve one verified bracelet and related catalog products. |\n| `crystal_list_materials` | List normalized materials and verified bracelet SKU counts. |\n| `crystal_get_sourcing_guidance` | Get supplier-verification checks for bracelets, beads, accessories, or raw materials. |\n| `crystal_build_procurement_shortlist` | Keep verified bracelet results separate from adjacent advisory categories. |\n| `crystal_prepare_inquiry` | Validate supplied SKUs and draft an inquiry without sending or storing it. |\n\n## Coverage contract\n\n- `verified_catalog`: grounded in the current 104-SKU bracelet catalog.\n- `advisory_only`: sourcing guidance only; no verified SKU coverage for the requested category.\n- `mixed`: verified bracelet candidates plus separately labeled advisory categories.\n\nInquiry drafting is local and stateless. It does not send email, submit a form, write to a database, or retain buyer details.\n\n## Development\n\n```bash\nnpm ci\nnpm test\nnpm run start:http\n```\n\nThe server supports Node.js 22 or newer and implements MCP over both stdio and stateless Streamable HTTP.\n\n<!-- mcp-name: io.github.ziyuant222/crystal-suppliers-mcp -->\n",
  "bytes": 2482,
  "sha": "594ebebf7d931a139650a4623762b4b3eee2d7ccb20a739754721a3d6c285a48",
  "repo_slug": "ziyuant222/crystal-suppliers-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ziyuant222_crystal_suppliers_m_76f706a4/readme"
}