gold-price-per-gram-mcp

gold-price-per-gram-mcp

The live gold price per gram for AI assistants, by karat and currency, with metal prices, jewelry melt value and exact gold unit conversion.

This is a Model Context Protocol (MCP) server. It reads the gold, silver, platinum and palladium spot price at call time and converts it with central-bank FX rates for about 160 currencies. It needs no API key.

Tools

Every result has structured JSON, a one-paragraph summary, as_of, source and more (the matching page on goldgramprice.com).

What it knows that your model does not

• Today's gold price. Spot moves every minute and a model's training data is months old.
• Today's exchange rate for INR, AED, SAR, PKR, EUR, GBP and about 150 more currencies.
• Exact unit constants. A troy ounce is 31.1034768 g and a grain is 64.79891 mg by definition (NIST Handbook 44). A tola is 180 grains. A Thai bullion baht is 15.244 g, not 15 g. A kitchen-scale ounce is 28.349523125 g, not a troy ounce.
• Karat purity as an exact fraction (karat / 24), so 22K is 91.6667% and 14K is 58.3333%.

Install

Hosted (Claude.ai custom connector, ChatGPT developer mode)

Paste this URL. No token, no sign-up.

https://gold-price-per-gram-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http gold-price https://gold-price-per-gram-mcp.lipmichal.workers.dev/mcp

Or run it locally over stdio:

claude mcp add gold-price -- npx -y github:theluckystrike/gold-price-per-gram-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "gold-price": { "command": "npx", "args": ["-y", "github:theluckystrike/gold-price-per-gram-mcp"] }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "gold-price": { "url": "https://gold-price-per-gram-mcp.lipmichal.workers.dev/mcp" }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "gold-price": { "type": "http", "url": "https://gold-price-per-gram-mcp.lipmichal.workers.dev/mcp" }
  }
}

Node 20 or newer is needed for the local stdio version.

Example prompts

• "What is the 22K gold price per gram in India today?"
• "How much is one tola of 24K gold in Pakistani rupees?"
• "I have a 14K chain that weighs 12 grams. What is its melt value, and what might a buyer offer at a 25% spread?"
• "Show gold, silver and platinum prices in euros."
• "How many grams are in a Thai baht of gold, and in a Vietnamese chi?"

Data sources

All keyless and free to use from a server. Full list with fetch dates in DATA_SOURCES.md.

• Spot prices from gold-api.com, the same feed goldgramprice.com uses. Its terms allow commercial use and ask callers not to send several requests per second, so the hosted server caches each price for 5 minutes.
• FX rates from Frankfurter, blended from the ECB and other central banks. Cached for 1 hour. Rates update once a working day.
• Unit constants from NIST Handbook 44 Appendix C. Karat definition from 16 CFR 23.3.

Limitations

• Prices are spot (melt) values for pure metal. Jewellery in a shop costs more (making charges, design, tax) and buyers pay less (refining and margin). The tools say so in every answer.
• The spot price can be up to 5 minutes old on the hosted server. FX rates are daily reference rates, not live market quotes.
• Purity uses the nominal karat fraction. Real items can be slightly under (legal tolerances) or over.
• Regional tael values differ (Hong Kong 37.429 g, Vietnam 37.5 g, Taiwan 37.5 g, China 50 g). Pick the one you mean.
• When a price feed is down, the tool returns a clear error instead of a stale or remembered number.

More

Karat calculators, scrap gold, city price pages and gold price history are on goldgramprice.com.

Part of the Zovo MCP collection: https://mcp.zovo.one

Development

npm install
npm test            # builds, then runs the fixture tests against saved upstream payloads
node scripts/smoke-stdio.mjs   # live stdio check, one real call per tool
npx wrangler deploy            # Cloudflare Worker, Streamable HTTP at /mcp

License

MIT

More data servers from the same author

Each one is free, needs no API key and has a hosted URL you can paste into Claude or ChatGPT.

The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one