How do I install Iran Gold?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Iran Gold need an API key?

No required environment variable is listed on this record.

What transport does Iran Gold use?

Iran Gold runs locally over stdio.

When was Iran Gold last checked?

Last checked 2026-10-28. Unofficial read-only live 18k gold prices on Iranian sites: Milli.gold, Wallgold, Melligold, Daric.

Iran Gold MCP server

iran-gold-mcp: live gold prices from Iranian gold platforms for AI agents

Compare the 18k gold price on Milli.gold, Wallgold, Melligold, Daric and Taline from your AI agent. An unofficial, read-only MCP server for Iranian online platforms that sell 18k melted gold (طلای آب‌شده): live buy and sell price per gram on each platform, the cheapest place to buy, the best place to sell, and Milli.gold's price history.

For AI agents · Quick start · Tools · Good to know · FAQ · فارسی

For AI agents

What: unofficial MCP server (model context protocol) for the public prices of five Iranian online gold platforms: milli.gold, wallgold.ir, melligold.com, daric.gold and taline.ir.
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, Daric as an order book with a separate bid and ask, and Taline only on its homepage. iran-gold-mcp reads all five 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 25,935,000 Toman per gram, then Wallgold (26,078,000), Melligold (26,133,565), Daric (26,209,064) and Taline (26,262,300). 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, Daric and Taline."
"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

Settings → Developer → Edit Config, then add:

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

Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.

Click Install in VS Code above, or add to .vscode/mcp.json:

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

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

It's a standard stdio MCP server: run uvx iran-gold-mcp, or pip install iran-gold-mcp and run iran-gold-mcp.

Tools

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

Tool	What it does
`gold_prices`	Compares the live 18k gold buy and sell price per gram (Toman) on Milli.gold, Wallgold, Melligold, Daric and Taline, cheapest first, with `best_to_buy` and `best_to_sell`. A platform that does not answer is listed under `failed`; the rest still return
`gold_milli_history`	Gets the Milli.gold 18k gold price series for a day, week or month (`period`: `DAILY`, `WEEKLY`, `MONTHLY`; `points`: 2-50, default 24) with first, last, high, low and change percent
`gold_milli_stats`	Gets Milli.gold's headline numbers: users, trade transactions, gold traded (kg), user balances (kg), burned gold (kg), branches and representatives

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.
Taline needs an Iranian connection. Taline puts its price only on its homepage and only for visitors from Iran; elsewhere it is listed under failed. Outside Iran set IRAN_GOLD_MCP_PROXY to an Iranian HTTP proxy.

FAQ

Not an official one. iran-gold-mcp calls the public, login-free price endpoints that the platforms' own websites use.

milligold-mcp covers Milli.gold only. iran-gold-mcp covers Milli.gold plus Wallgold, Melligold, Daric and Taline and compares them. tgju-mcp gives market-wide rates for dollar, coins, gold and crypto.

No, and that's deliberate. It has no login and only reads public data.

Not by default. If requests are blocked from your network, set IRAN_GOLD_MCP_PROXY to an HTTP proxy. System proxy variables are ignored on purpose.

Configuration

Variable	Default	Meaning
`IRAN_GOLD_MCP_PROXY`	unset	Optional HTTP proxy URL for the platform requests. A comma-separated list is used one at a time: the next proxy takes over when one is blocked or cannot connect. System proxy settings are ignored

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

iran-gold-mcp یک سرور MCP غیررسمی و فقط‌خواندنی است که قیمت لحظه‌ای طلای ۱۸ عیار آب‌شده را از پلتفرم‌های آنلاین میلی، وال‌گلد، ملی‌گلد، داریک و طلاین می‌خواند و مقایسه می‌کند.

قیمت خرید و فروش هر گرم (تومان) در هر پلتفرم، از ارزان‌ترین به گران‌ترین، با بهترین جا برای خرید و فروش.
تاریخچه قیمت میلی در روز، هفته و ماه گذشته و آمار پلتفرم میلی.
فقط خواندنی است: خرید و فروش نمی‌کند و وارد حساب نمی‌شود. کارمزد پلتفرم‌ها در قیمت‌ها حساب نشده است.
طلاین قیمت را فقط به بازدیدکننده‌های داخل ایران نشان می‌دهد؛ بیرون از ایران IRAN_GOLD_MCP_PROXY را روی یک پراکسی ایرانی بگذارید.

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, Daric or Taline. 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

Iran Gold

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Iran Gold?

Does Iran Gold need an API key?

What transport does Iran Gold use?

When was Iran Gold last checked?

Documentation

iran-gold-mcp: live gold prices from Iranian gold platforms for AI agents

For AI agents

Why

Quick start

Tools

Good to know

FAQ

Configuration

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

Development

Related servers

Disclaimer

Author

License