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 and statistics endpoints 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: 3, all prefixed mg_. Typical sequence: mg_get_price -> mg_price_history.
• 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, or Milli.gold's headline numbers.
• Do not use when: the user wants to 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 awesome-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
• 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?"
• قیمت طلای ۱۸ عیار در میلی الان هر گرم چند تومان است؟
• نمودار قیمت طلا در میلی در یک هفته گذشته چطور بوده؟
• امروز قیمت طلا در میلی بالا رفته یا پایین آمده؟

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 3 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

milligold-mcp runs locally and calls three public, login-free endpoints of milli.gold: the live price, the price widget series and the overall report. 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.
• 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
• awesome-iran-mcp: catalog of all Iranian-service MCP servers

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.

License

MIT