For AI agents

• What: unofficial MCP server (model context protocol) for the public price endpoints of four Iranian online gold platforms: milli.gold, wallgold.ir, melligold.com and daric.gold.
• Install: uvx iran-gold-mcp or claude mcp add iran-gold -- uvx iran-gold-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional IRAN_GOLD_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
• Access: read-only, so no confirmation is needed before calling any tool. It cannot log in, trade or read a wallet.
• Tools: 3, all prefixed gold_. Typical sequence: gold_prices -> gold_milli_history.
• Use when: the user asks what 18k melted gold costs per gram on these platforms, where it is cheapest to buy or best to sell, or how the Milli.gold price moved over a day, week or month.
• Do not use when: the user wants to buy or sell gold, or wants dollar, coin or crypto prices (see tgju-mcp).
• Output: compact JSON. gold_prices is Toman per gram of 18k gold; gold_milli_history is Rial per milligram. Times are Tehran time.

Why

Every Iranian gold platform quotes its own price, in its own unit: Milli.gold in Rial per milligram, the others in Toman per gram, and Daric as an order book with a separate bid and ask. iran-gold-mcp reads all four at once, converts them to Toman per gram and sorts them:

You: Where is 18k gold cheapest to buy right now?

Agent: calls gold_prices()

Milli.gold is cheapest at 26,019,000 Toman per gram, then Wallgold (26,202,000), Melligold (26,248,700) and Daric (26,332,312). Platform fees are not included.

_{Real prices from 2026-10-27; they change all the time.}

Example prompts:

• "Compare the 18k gold price per gram on Milli, Wallgold, Melligold and Daric."
• "Where should I sell 2 grams of melted gold right now?"
• "Show me Milli.gold's gold price for the last month. What were the high and the low?"
• قیمت طلای آب‌شده الان در کدام سایت ارزان‌تر است؟
• قیمت هر گرم طلای ۱۸ عیار در میلی، وال‌گلد، ملی‌گلد و داریک را مقایسه کن.

Quick start

You need uv. No API key or account.

claude mcp add iran-gold -- uvx iran-gold-mcp

{
  "mcpServers": {
    "iran-gold": { "command": "uvx", "args": ["iran-gold-mcp"] }
  }
}

{
  "servers": {
    "iran-gold": { "type": "stdio", "command": "uvx", "args": ["iran-gold-mcp"] }
  }
}

codex mcp add iran-gold -- uvx iran-gold-mcp

Tools

All 3 tools are read-only and return compact JSON.

Good to know

• Buy and sell. buy is what you pay per gram on that platform, sell what you get when you sell. Milli.gold, Wallgold and Melligold often show one price for both; Daric is an order book, so buy is the best ask and sell the best bid.
• Fees are not included. Platforms charge a trading fee (often around 0.5 %) on top of the price.
• Platform prices, not market quotes. Each number is that platform's own price for 18k melted gold, so expect small differences from tgju and from each other.
• Units. Milli.gold quotes Rial per milligram; gold_prices converts it (x100 = Toman per gram). gold_milli_history keeps Rial per milligram.
• Tehran time. as_of and history time values are Tehran time (UTC+3:30).
• 15 s cache. Repeated calls within 15 seconds reuse the answer.
• Not covered. Taline (tlyn) shows its price only after login, so it is not included.

FAQ

Configuration

فارسی: سرور MCP قیمت طلای آب‌شده

claude mcp add iran-gold -- uvx iran-gold-mcp

Development

git clone https://github.com/sepehr071/iran-gold-mcp && cd iran-gold-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests
uv run python -m pytest -m live -q  # calls the real platforms
uv build

Related servers

• milligold-mcp for Milli.gold only
• tgju-mcp for dollar, euro, gold, coin, crypto and commodity prices from tgju.org
• iran-mcp: catalog of all Iranian-service MCP servers

Disclaimer

Unofficial and not affiliated with or endorsed by Milli.gold, Wallgold, Melligold or Daric. It is read-only and uses public endpoints that can change without notice. Prices are informational and not financial advice.

Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp.

License

MIT