Crystal Suppliers MCP
RemoteAbout Crystal Suppliers MCP
Crystal Suppliers MCP is a read-only procurement service for KT Crystals, letting buyers search a verified bracelet catalog and get sourcing checks for beads, accessories, and raw crystals. It distinguishes verified products from advisory-only guidance.
Key features
- 01Search bracelets by SKU, name, material, or theme
- 02Retrieve products and related catalog items
- 03List materials and verified SKU counts
- 04Get category-specific sourcing checks
- 05Build shortlists and draft inquiries
Use cases
- 01Find crystal bracelets in the catalog
- 02Check sourcing details for beads or raw crystals
- 03Validate SKUs and draft an inquiry
MCP support
The service exposes MCP tools for product search and lookup, material listings, sourcing guidance, procurement shortlists, and inquiry drafting. It supports stdio and stateless Streamable HTTP.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://ktcrystals.com/mcpclaude mcp add --transport http ziyuant222-crystal-suppliers https://ktcrystals.com/mcp{"mcpServers":{"ziyuant222-crystal-suppliers":{"type":"http","url":"https://ktcrystals.com/mcp"}}}Open in Cursor{"servers":{"ziyuant222-crystal-suppliers":{"type":"http","url":"https://ktcrystals.com/mcp"}}}Open in VS Code{"mcpServers":{"ziyuant222-crystal-suppliers":{"type":"http","url":"https://ktcrystals.com/mcp"}}}{"mcpServers":{"ziyuant222-crystal-suppliers":{"serverUrl":"https://ktcrystals.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0stdioTools
6| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | |
| query | string | No | |
| cursor | string | No | |
| channel | string | No | |
| category | enum | No | bracelets | beads | accessories | raw_materials |
| useCases | array | No | |
| materials | array | No | |
| benefitTags | array | No |
Details
From the project READMECrystal Suppliers MCP
Crystal Suppliers MCP is a read-only procurement server for KT Crystals. It searches a verified catalog of 104 crystal bracelet SKUs and provides traceable sourcing checklists for loose beads, crystal accessories, and raw crystal materials.
The service does not invent price, MOQ, inventory, lead time, treatment, origin, certification, or shipping claims. Commercial fields remain requires_manual_confirmation.
Install and connect
Run directly from the repository:
{
"mcpServers": {
"crystal-suppliers": {
"command": "node",
"args": ["/absolute/path/to/crystal-suppliers-mcp/src/index.mjs"]
}
}
}
Run the OCI image over stdio:
{
"mcpServers": {
"crystal-suppliers": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0"
]
}
}
}
Start Streamable HTTP:
docker run --rm -p 3000:3000 \
ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0 --http
The endpoint is then http://localhost:3000/mcp, with health status at http://localhost:3000/health.
Tools
| Tool | Purpose |
|---|---|
crystal_search_products | Search real bracelet SKUs by SKU, name, material, or theme. |
crystal_get_product | Retrieve one verified bracelet and related catalog products. |
crystal_list_materials | List normalized materials and verified bracelet SKU counts. |
crystal_get_sourcing_guidance | Get supplier-verification checks for bracelets, beads, accessories, or raw materials. |
crystal_build_procurement_shortlist | Keep verified bracelet results separate from adjacent advisory categories. |
crystal_prepare_inquiry | Validate supplied SKUs and draft an inquiry without sending or storing it. |
Coverage contract
verified_catalog: grounded in the current 104-SKU bracelet catalog.advisory_only: sourcing guidance only; no verified SKU coverage for the requested category.mixed: verified bracelet candidates plus separately labeled advisory categories.
Inquiry drafting is local and stateless. It does not send email, submit a form, write to a database, or retain buyer details.
Development
npm ci
npm test
npm run start:http
The server supports Node.js 22 or newer and implements MCP over both stdio and stateless Streamable HTTP.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.