iran-gold-mcp
A read-only MCP server for checking Iranian 18k melted-gold prices and Milli.gold history/statistics.
Compare live buy/sell prices per gram in Toman across platforms such as Milli.gold, Wallgold, Melligold, Daric, Taline, and Talano.
Find the cheapest platform to buy from and the best platform to sell on, with failed platforms reported separately.
Retrieve Milli.gold 18k gold price history for daily, weekly, or monthly windows, including high, low, and change percent.
Retrieve Milli.gold platform statistics such as users, trades, gold traded, gold held, and branches.
Uses public data only; it cannot log in, trade, or access wallets.
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., "@iran-gold-mcp Where is 18k gold cheapest to buy right now?"
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.
iran-gold-mcp: live gold prices from Iranian gold platforms for AI agents
Compare the 18k gold price on Milli.gold, Wallgold, Melligold, Daric, Taline and Talano 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 six Iranian online gold platforms: milli.gold, wallgold.ir, melligold.com, daric.gold, taline.ir and talano.ir.
Install:
uvx iran-gold-mcporclaude 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_pricesis Toman per gram of 18k gold;gold_milli_historyis Rial per milligram. Times are Tehran time.
Related MCP server: Arzbin MCP Server
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 six 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()Talano is cheapest at 25,261,000 Toman per gram, then Milli.gold (25,935,000), 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, Taline and Talano."
"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-mcpSettings → 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-mcpIt'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 |
| Compares the live 18k gold buy and sell price per gram (Toman) on Milli.gold, Wallgold, Melligold, Daric, Taline and Talano, cheapest first, with |
| Gets the Milli.gold 18k gold price series for a day, week or month ( |
| 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.
buyis what you pay per gram on that platform,sellwhat you get when you sell. Milli.gold, Wallgold and Melligold often show one price for both; Daric is an order book, sobuyis the best ask andsellthe 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 and Talano thousand Toman per gram;
gold_pricesconverts both to Toman per gram.gold_milli_historykeeps Rial per milligram.Tehran time.
as_ofand historytimevalues 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 setIRAN_GOLD_MCP_PROXYto 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, Taline and Talano 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 |
| 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-mcpDevelopment
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 buildRelated 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
mcpfarsi.ir: Persian marketplace of MCP servers for Iranian services
Disclaimer
Unofficial and not affiliated with or endorsed by Milli.gold, Wallgold, Melligold, Daric, Taline or Talano. 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
Available Tools
3 toolsgold_milli_historyMilli.gold price historyARead-onlyIdempotent
Get the Milli.gold 18k gold price series for a day, week or month, with high, low and change.
Rial per milligram (x100 = Toman per gram), Tehran time. For today's price on every platform use gold_prices.
Inputs: period, points.
gold_milli_statsMilli.gold platform statisticsARead-onlyIdempotent
Get Milli.gold's headline numbers: users, trades, gold traded, gold held and branches.
Rounded published totals; weights in kilograms. For prices use gold_prices.
Inputs: no named parameters.
gold_pricesLive gold prices on Iranian platformsARead-onlyIdempotent
Compare the live 18k melted-gold price on Milli.gold, Wallgold, Melligold, Daric, Taline and Talano, in Toman per gram.
buy is what you pay, sell what you get; rows are cheapest-buy first. Platforms that did not answer are listed
under failed. Fees are not included. For Milli.gold trends use gold_milli_history.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool occupies a distinct niche: cross-platform live price comparison, Milli.gold time series, and Milli.gold platform statistics. Descriptions explicitly cross-reference each other to steer agents to the right tool, leaving no realistic overlap.
All three names use a consistent snake_case `gold_`-prefixed noun pattern (gold_prices, gold_milli_history, gold_milli_stats). The naming predicts both the resource and the granularity.
Three tools is on the thin side, but the domain is narrow (Iranian gold price lookup) and each tool covers a genuinely different question. Nothing superfluous, nothing obviously missing in count.
Current prices, historical series, and platform stats cover the core lifecycle of price research. The main gap is that history and stats exist only for Milli.gold, so agents cannot trend other platforms like Wallgold or Taline.
Maintenance
Related MCP Connectors
Live gold price per gram by karat and currency, metal prices, jewelry melt value, unit conversion.
Live gold & silver prices for 37 countries. Tamara/Tabby installment calculators for Saudi Arabia.
Live and historical prices for gold, silver and other metals, energy, currencies and crypto.
Gold/silver price aggregator: 29 free tools incl. show_floor_sheet, spot_move_check. Not a dealer.
Related MCP Servers
- FlicenseAqualityDmaintenanceProvides real-time gold prices from Vietnamese and international markets via the vang.today API.3-

Arzbin MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceLive Iran exchange rates, gold, crypto, and Toman/Rial market data for AI agents.2MIT- AlicenseNot gradedqualityBmaintenanceEnables access to live precious metals prices, historical data, market intelligence, and portfolio management with AI/LLM integration.ISC
- AlicenseAqualityBmaintenanceEnables AI agents to fetch the live 18k gold price per milligram, gram in Rial and Toman, plus daily, weekly and monthly price history and platform statistics from Milli.gold through read-only tools. Supports Claude, Cursor and Copilot over stdio with no API key or account required.8209 PyPIMIT