Crystal Suppliers MCP

io.github.ziyuant222Published by GitHub account ziyuant222v0.1.1Updated Oct 25, 2026

Search verified crystal bracelets and source beads, accessories, and raw materials.

VerifiedStreamable HTTPWeb executableDatabasesBusiness & Commerce

Overview

AI-generated overview

A read-only crystal procurement server that lets an assistant search a verified 104-SKU bracelet catalog and draft wholesale inquiries.

What you can do
Search and retrieve verified bracelet SKUs by SKU, name, material, or theme, with materials, images, and source links. List normalized materials with real bracelet SKU counts. Get source-linked sourcing checks for bracelets, loose beads, accessories, and raw materials. Build a shortlist that keeps verified bracelets separate from advisory-only categories. Validate supplied SKUs and draft an English wholesale inquiry without sending or storing it.
When to use it
Useful when sourcing crystal bracelets or related materials and you want catalog-grounded product lookups and a draft inquiry rather than invented prices, MOQ, or stock figures. The adjacent bead, accessory, and raw-material categories are advisory only.
Requirements
Runs as a remote endpoint or locally via Node.js 22 or newer, or the OCI image over stdio or Streamable HTTP. No accounts, API keys, environment variables, or headers are declared.
Before you install
Commercial terms such as price, MOQ, stock, lead time, and certificates are never provided and always require manual confirmation. The inquiry tool is read-only and does not send, store, or submit buyer data. Beads, accessories, and raw materials have no verified SKU coverage.

Installation

In SourceWeft

  1. Open Crystal Suppliers MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ziyuant222%2Fcrystal-suppliers-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "crystal-suppliers": {
      "type": "http",
      "url": "https://ktcrystals.com/mcp"
    }
  }
}

README

Crystal 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:

json
{  "mcpServers": {    "crystal-suppliers": {      "command": "node",      "args": ["/absolute/path/to/crystal-suppliers-mcp/src/index.mjs"]    }  }}

Run the OCI image over stdio:

json
{  "mcpServers": {    "crystal-suppliers": {      "command": "docker",      "args": [        "run",        "--rm",        "-i",        "ghcr.io/ziyuant222/crystal-suppliers-mcp:0.1.0"      ]    }  }}

Start Streamable HTTP:

bash
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

ToolPurpose
crystal_search_productsSearch real bracelet SKUs by SKU, name, material, or theme.
crystal_get_productRetrieve one verified bracelet and related catalog products.
crystal_list_materialsList normalized materials and verified bracelet SKU counts.
crystal_get_sourcing_guidanceGet supplier-verification checks for bracelets, beads, accessories, or raw materials.
crystal_build_procurement_shortlistKeep verified bracelet results separate from adjacent advisory categories.
crystal_prepare_inquiryValidate 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

bash
npm cinpm testnpm run start:http

The server supports Node.js 22 or newer and implements MCP over both stdio and stateless Streamable HTTP.

Source: README.md at commit e945d2a

Tools

6

crystal_search_products

Search Crystal Products

Search the verified 104-SKU bracelet catalog by SKU, name, material, or theme. Beads, accessories, and raw materials return advisory-only coverage with no fabricated SKUs. Commercial terms always require manual confirmation.

ParameterslimitquerycursorchannelcategoryuseCasesmaterialsbenefitTags

crystal_get_product

Get Crystal Product

Get one verified bracelet by exact SKU or slug, including materials, image, source URL, related SKUs, and explicit manual-confirmation status for commercial terms.

Parametersskuslug

crystal_list_materials

List Bracelet Materials

List normalized materials and real SKU counts from the current verified bracelet catalog. Counts do not claim coverage for loose beads, components, or raw crystals.

Parameterslimitquerycursor

crystal_get_sourcing_guidance

Get Crystal Sourcing Guidance

Get source-linked procurement checks for bracelets, loose beads, accessories, or raw materials. Adjacent categories are advisory only and never return invented inventory or SKUs.

ParameterschannelcategoryrequiredpackagingdestinationcontentAssetsproofRequirements

crystal_build_procurement_shortlist

Build Crystal Procurement Shortlist

Build a deterministic shortlist across requested crystal categories. Verified products are limited to catalog bracelets; other categories remain clearly separated advisory items.

ParameterslimitcolorscursorchanneluseCasesmaterialspackagingcategoriesrequireddestinationcontentAssetstargetQuantitytargetTimeline

crystal_prepare_inquiry

Prepare Crystal Wholesale Inquiry

Validate any supplied bracelet SKUs and draft an English wholesale inquiry. This read-only tool never sends, stores, or submits buyer data and never invents price, MOQ, stock, lead time, or certificates.

ParametersnameskusemailchannelcompanycountryquantitymaterialspackagingrequirementscontentAssetstargetTimeline+1 more

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts