Milli.gold Prices

milligold-mcp: Milli.gold price MCP server for AI agents

Give your AI agent the live 18k gold price from Milli.gold (میلی).
An unofficial, read-only MCP server for Milli.gold, an Iranian online platform for 18k gold sold by the milligram:
the live gold price per gram, day, week and month price history, and platform statistics, all from Claude, Cursor or Copilot.

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

For AI agents

• What: unofficial MCP server (model context protocol) for the public price, statistics, fees, news and help pages of milli.gold. A gold price API for Iran in tool form.
• Install: uvx milligold-mcp or claude mcp add milligold -- uvx milligold-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional MILLIGOLD_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: 8, all prefixed mg_. Typical sequences: mg_get_price -> mg_price_history; mg_trade_quote; mg_latest_posts or mg_help_topics -> mg_read.
• Use when: the user asks for the current 18k gold price per gram on Milli.gold, how it moved over a day, week or month, what a buy or sale costs with fees, Milli.gold's fees, its latest gold news, or how to use Milli (delivery, transfer, verification).
• Do not use when: the user wants to actually buy or sell gold, needs a market-wide quote, or wants dollar, coin or crypto prices (see tgju-mcp).
• Output: compact JSON. Milli.gold quotes Rial per milligram of 18k gold; replies also carry Rial per gram and Toman per gram. Times are Tehran time.
• Machine-readable: server.json and the iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Why

Milli.gold sells 18k melted gold by the milligram, so its price is quoted per milligram, in Rial. The site shows the price per gram, and the numbers are easy to misread by a factor of 10 or 1000. An agent with milligold-mcp reads the quote straight from the public endpoints and does the unit conversion for you:

You: What is the Milli.gold gold price right now, and is it up or down this week?

Agent: calls mg_get_price() -> mg_price_history(period="WEEKLY")

One gram of 18k gold costs 26,890,000 Toman on Milli.gold (268,900 Rial per milligram). Over the past week it moved by the percentage shown in change_percent, between the week's low and high.

_{Illustrative example with the price from the site's own unit explanation; prices change all the time.}

What it can do

• Live price of 18k gold on Milli.gold: Rial per milligram, Rial per gram and Toman per gram, with the Tehran-time timestamp
• Price history for the last day, week or month, with first, last, high, low and change percent
• Platform statistics: users, trade transactions, gold traded and held (kg), burned gold (kg), branches and representatives
• Fees for buying, selling, transferring and delivering gold and for wallet withdrawals, read live from the fees page
• Trade quotes: what buying N grams (or spending a Toman budget) costs, or what selling pays, fee included
• News, magazine and help: the newest posts (daily gold, ounce and market reports), help articles found by keyword, and the full text of any post
• Read-only by design: no login, no trading, no wallet

Example prompts:

• "What is the 18k gold price per gram on Milli.gold right now?"
• "Show me Milli.gold's gold price for the last month. What were the high and the low?"
• "Is gold up or down today on Milli.gold? Give me the change in percent."
• "How many users and how much gold does Milli.gold report?"
• "How much do I pay on Milli.gold for 2 grams of gold, fee included?"
• "How do I get physical gold delivered from Milli, and what does it cost?"
• با ۵ میلیون تومان چند میلی طلا در میلی می‌توانم بخرم؟
• آخرین اخبار قیمت طلا در میلی چیست؟
• قیمت طلای ۱۸ عیار در میلی الان هر گرم چند تومان است؟
• نمودار قیمت طلا در میلی در یک هفته گذشته چطور بوده؟
• امروز قیمت طلا در میلی بالا رفته یا پایین آمده؟

Quick start

You need uv. No API key or account.

claude mcp add milligold -- uvx milligold-mcp

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

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

codex mcp add milligold -- uvx milligold-mcp

[mcp_servers.milligold]
command = "uvx"
args = ["milligold-mcp"]

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

Tools

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

How it works

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  milligold-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  milli.gold   price, price history, platform report, fees page, RSS feeds, help sitemap, posts

milligold-mcp runs locally and reads public, login-free parts of milli.gold: three JSON endpoints (live price, price widget series, overall report), the fees page, the news, magazine and help RSS feeds, the help sitemap and the post pages. There is no hosted server in between and no API key.

• Chrome-like client. Requests go through a Chrome-impersonating HTTP client, because the site sits behind ArvanCloud.
• ArvanCloud 307 + cookie. ArvanCloud sometimes answers with a redirect to the same URL plus a cookie. The server retries once and keeps the cookie, so you never see it.
• 15 s cache. Repeated calls within 15 seconds reuse the answer instead of hitting the site again.
• Read-only. Only GET requests, only to milli.gold. System proxy variables are ignored on purpose.

Good to know

• Units. The site quotes price18 in Rial per milligram, and 1 gram = 1000 mg. So 268,900 Rial/mg x 1000 = 268,900,000 Rial/g, and Rial / 10 = 26,890,000 Toman/g, which matches "price of 1 gram of 18k gold" on the site.
• Tehran time. as_of and history time values are Tehran time (UTC+3:30).
• Milli.gold's own price. It is the platform's quote for 18k melted gold, with no tax or making charge. It is not a market-wide quote and not the tgju price, so expect small differences from other sources.
• History stats follow the site. The high, low and change for a week or a month include the day's peak and the live price, like the Milli.gold page does. points only thins the returned series; it does not change the stats.
• Statistics are rounded totals that the company publishes, with weights in kilograms.
• Trade quotes are estimates. The fee is the larger of the minimum and the percent on the fees page (today 1 mg or 0.5 %). New-user fee waivers and wallet withdrawal fees are not applied, and the price moves between the quote and a real trade.
• Posts. Only the newest posts are available (about 20 news, 10 magazine, 10 help); the site's feeds have no search or older pages. Help articles are found by the English words in their URLs. Post text is Persian.
• What it does not do. No buying or selling, no login, no wallet or account data.

FAQ

Configuration

فارسی: سرور MCP قیمت طلای میلی

claude mcp add milligold -- uvx milligold-mcp

Development

git clone https://github.com/sepehr071/milligold-mcp && cd milligold-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 milli.gold
uv build

Tools live in src/milligold_mcp/gold.py; each is a typed async function with a docstring that tells the agent when to use it. Releases: bump the version in pyproject.toml and server.json, then push a v* tag.

Related servers

• tgju-mcp for dollar, euro, gold, coin, crypto and commodity prices from tgju.org
• iran-crypto-mcp for cryptocurrency prices on Iranian exchanges
• tsetmc-mcp for Tehran Stock Exchange data
• iran-mcp: catalog of all Iranian-service MCP servers
• Listed on mcpfarsi.ir, the Persian MCP marketplace

Disclaimer

Unofficial and not affiliated with or endorsed by Milli.gold. It is read-only and uses public endpoints of milli.gold, which 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. If this saves you time, a star on the repo helps other people find it.

License

MIT