Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Arham Jewellers MCP Server what is today's gold rate?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP (Model Context Protocol) server for the Arham Jewellers customer AI assistant. Exposes tools for searching products, browsing categories, checking gold rates, tracking orders, placing orders, and getting store info.
Node.js 18+ (uses built-in fetch)
A running Arham Jewellers backend API
Related MCP server: Shiprocket MCP
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env with your API_BASE_URL
# Build
npm run buildCreate a .env file — only the API base URL is needed (token is passed per request):
API_BASE_URL=https://arham-jewellers-backend.onrender.comnpm start# Admin login (phone must include +91 prefix)
LOGIN_PHONE=+919879879870 LOGIN_PASSWORD=Admin@1234 npm run get-token
# User login
LOGIN_PHONE=+919879879870 LOGIN_PASSWORD=yourpass npm run get-tokenAll tools require a token parameter (JWT) passed by the MCP client with each request.
Tool | Description |
| Search products by name, karat, or category |
| Get full details of a specific product |
| Find a product by barcode number |
| Get the hierarchical category tree (Level 1=Karat, 2=Collection, 3=Style) |
| List products in a Level 3 category |
| Get today's gold rate per gram |
| Get historical gold rates |
| Get order history |
| Get details of a specific order |
| Place an order (requires user confirmation) |
| Get store info (About, Contact, Terms, etc.) |
Category levels: Only Level 3 (Style) category IDs return products. Use get_categories(level=3) to find valid IDs.
Order placement: place_order uses a two-step confirm flow — the AI must ask the user before setting confirm=true.
Gold rate: The /api/v1/gold-rate/current endpoint may not be available on all backend versions.
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"arham-jewellers": {
"command": "node",
"args": [
"--env-file=/absolute/path/to/arham-mcp-server/.env",
"/absolute/path/to/arham-mcp-server/build/index.js"
]
}
}
}Add to .cursor/mcp.json:
{
"mcpServers": {
"arham-jewellers": {
"command": "node",
"args": [
"--env-file=/absolute/path/to/arham-mcp-server/.env",
"/absolute/path/to/arham-mcp-server/build/index.js"
]
}
}
}src/
├── index.ts # Entry point (MCP server + STDIO transport)
├── config.ts # Environment variable loader
├── api-client.ts # HTTP client for backend API (token passed per call)
├── types.ts # TypeScript interfaces
└── tools/
├── index.ts # Tool registry
├── products.ts # search_products, get_product_details, get_product_by_barcode
├── categories.ts # get_categories, get_category_products
├── gold-rate.ts # get_current_gold_rate, get_gold_rate_history
├── orders.ts # get_user_orders, get_order_details, place_order
└── store.ts # get_store_infoBrowse categories step by step. Call with no params to see Karat options (Level 1). Pass a parent_id to see its children (Level 2=Collection or Level 3=Style). Only Level 3 IDs work with get_category_products. Ask the user what they are looking for (karat, collection, style) before drilling down.
Inputs: parent_id, level.
Get products in a category. IMPORTANT: category_id MUST be a Level 3 (Style) ID. Use get_categories with parent_id to drill down to Level 3 first. Level 1 and Level 2 IDs will return 0 products.
Inputs: category_id (required), page, limit.
Get the current gold rate per gram. Returns the latest rate set by the store.
Inputs: no named parameters.
Get historical gold rates. Returns a list of past rate entries.
Inputs: page, limit.
Get details of a specific order from the user's order history. Returns full order info including all items.
Inputs: order_id (required).
Find a product by its barcode number. Useful when a customer scans or reads a barcode.
Inputs: barcode (required).
Get detailed information about a specific product by its ID. Use this after search_products to get full details of a product.
Inputs: product_id (required).
Get store information like contact details, about us, terms, refund policy, etc.
Inputs: page.
Get order history for a user. Returns a paginated list of orders with their items and status.
Inputs: page, limit.
Place an order for one or more products. IMPORTANT: Ask the user to confirm before placing an order. This action will create a real order in the system.
Inputs: items (required), confirm (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 10 tools
Each tool has a clearly distinct purpose: browsing categories, retrieving products in a category, gold rates, orders, barcode lookup, product details, store info, user orders, and placing orders. No overlap between tools.
All tools follow a consistent verb_noun pattern with underscore separators (e.g., get_categories, place_order). No mixing of conventions.
10 tools are well-scoped for a jewelry store MCP server, covering browsing, ordering, and store information without being overly numerous or too few.
The tool set covers core operations (browse, get details, order), but notably lacks a search tool despite get_product_details referencing search_products. Missing update/delete for orders and customer support tools, leaving moderate gaps.
Live fine-jewelry catalog: search, product lookup, compatible chains, size/length variants, store po
FiLot gives an AI assistant the world gold price per gram in your currency, the price on a past date, and zakat on gold. Each price comes with a signature and a link to check it. It also checks gold bar records and, for Indonesia, gives dealer buyback prices and gold tax. In public beta. No FiLot account needed.
Live gold & silver prices for 37 countries. Tamara/Tabby installment calculators for Saudi Arabia.
AI-powered commerce API for luxury skincare shopping. Enables AI agents to search products, browse collections, manage shopping carts, and generate checkout URLs for the Regenique Elegance Shopify store.
