Skip to main content
Glama
milligold-mcp

milligold-mcp

by sepehr071

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.

PyPI Python CI MCP Registry License: MIT mcpfarsi

Install in Cursor Install in VS Code

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).

Related MCP server: Arzbin MCP Server

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

Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "milligold": { "command": "uvx", "args": ["milligold-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": {
    "milligold": { "type": "stdio", "command": "uvx", "args": ["milligold-mcp"] }
  }
}
codex mcp add milligold -- uvx milligold-mcp

Or add to ~/.codex/config.toml:

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

Add to ~/.gemini/settings.json:

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

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

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

Tools

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

Tool

What it does

mg_get_price

Gets the current Milli.gold price of 18k melted gold in Rial per milligram, Rial per gram and Toman per gram, with the Tehran-time timestamp

mg_price_history

Gets the 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

mg_platform_stats

Gets Milli.gold's headline numbers: users, trade transactions, gold traded (kg), user balances (kg), burned gold (kg), branches and representatives

mg_fees

Gets the current fees for buying, selling, transferring and delivering gold and for wallet withdrawals (customer: individual or company), each as percent with minimum and maximum

mg_trade_quote

Estimates the cost of a buy or the payout of a sale at the live price, fee included (side: buy or sell; grams, or toman as a buying budget)

mg_latest_posts

Lists the newest posts with date, categories, summary and URL (section: news, mag or help; limit: 1-20)

mg_help_topics

Finds help-center articles by English keyword (e.g. delivery, fee, card); empty query lists all

mg_read

Reads the text of one milli.gold news, magazine or help post (url; max_chars: 500-20000, default 6000)

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

Yes: milligold-mcp is an unofficial MCP server with 8 read-only tools. It calls the public price and statistics endpoints and reads the public fees, news and help pages that milli.gold itself serves; no API key is needed.

Add the server with claude mcp add milligold -- uvx milligold-mcp (or the matching config in Quick start), then ask "What is the 18k gold price per gram on Milli.gold?" in English or Persian.

Milli.gold quotes Rial per milligram. Every reply also carries Rial per gram (x 1000) and Toman per gram (Rial per gram / 10).

tgju-mcp reads tgju.org: dollar, euro, gold, coins, crypto and commodity prices across the Iranian market. milligold-mcp reads one platform, Milli.gold, and gives that platform's own gold price per milligram and its history. Use tgju-mcp for market rates and wide comparisons; use milligold-mcp when the question is about the price on Milli.gold specifically.

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

It is unofficial and not affiliated with Milli.gold. It is read-only, runs on your machine and is free under the MIT license.

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

Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.

Configuration

Variable

Default

Meaning

MILLIGOLD_MCP_PROXY

unset

Optional HTTP proxy URL for milli.gold 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 قیمت طلای میلی

milligold-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای میلی (Milli.gold)، پلتفرم آنلاین خرید و فروش طلای ۱۸ عیار آب‌شده به‌صورت میلی‌گرمی، است. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد قیمت لحظه‌ای طلا، تاریخچه قیمت، آمار پلتفرم، کارمزدها، هزینه معامله و اخبار و راهنمای میلی را بخواند.

چه کارهایی می‌کند

  • قیمت هر گرم طلای ۱۸ عیار در میلی: ریال به ازای هر میلی‌گرم، ریال به ازای هر گرم و تومان به ازای هر گرم.

  • تاریخچه قیمت روز، هفته و ماه گذشته، با اولین، آخرین، بیشترین و کمترین قیمت و درصد تغییر.

  • آمار پلتفرم: تعداد کاربران، تعداد معاملات، طلای معامله‌شده و نگه‌داری‌شده (کیلوگرم)، طلای سوزانده‌شده و تعداد شعبه‌ها و نمایندگی‌ها.

  • کارمزدها: کارمزد خرید، فروش، انتقال، تحویل طلا و برداشت از کیف پول، مستقیم از صفحه کارمزدهای سایت.

  • محاسبه هزینه معامله: هزینه خرید چند گرم طلا (یا با یک بودجه تومانی) و مبلغ دریافتی از فروش، با کارمزد.

  • اخبار، مجله و راهنما: تازه‌ترین مطالب (گزارش روزانه قیمت طلا و اونس)، جستجوی مقاله‌های راهنما و خواندن متن کامل هر مطلب.

نکته‌ها

  • فقط خواندنی است: خرید و فروش نمی‌کند، وارد حساب نمی‌شود و به کیف پول دسترسی ندارد.

  • قیمت، قیمت خود میلی است (بدون مالیات و اجرت)، نه قیمت بازار و نه قیمت tgju؛ برای نرخ دلار، سکه و ارز دیجیتال از tgju-mcp استفاده کنید.

  • هر ۱ گرم برابر ۱۰۰۰ میلی‌گرم است؛ ۲۶۸٬۹۰۰ ریال به ازای هر میلی‌گرم یعنی ۲۶٬۸۹۰٬۰۰۰ تومان برای هر گرم.

  • زمان‌ها به وقت تهران است. پاسخ‌ها ۱۵ ثانیه نگه داشته می‌شوند.

  • روی سیستم خود شما اجرا می‌شود و کلید API لازم ندارد.

نصب (اول uv را نصب کنید). در Claude Code:

claude mcp add milligold -- uvx milligold-mcp

در Claude Desktop، Cursor و بقیه برنامه‌ها همان تنظیم بخش Quick start را بگذارید.

نمونه پرسش‌ها

  • «قیمت طلای ۱۸ عیار در میلی الان هر گرم چند تومان است؟»

  • «قیمت طلا در میلی در یک ماه گذشته بیشترین و کمترین چقدر بوده؟»

  • «امروز طلای آب‌شده در میلی گران‌تر شده یا ارزان‌تر؟»

  • «آمار میلی را بگو: چند کاربر و چقدر طلا؟»

کلیدواژه‌ها: قیمت طلا، قیمت طلای ۱۸ عیار، خرید طلا آنلاین، طلای آب‌شده، قیمت هر گرم طلا، طلای دیجیتال، میلی.

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.

  • 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

Available Tools

8 tools
mg_feesMilli.gold feesA
Read-onlyIdempotent

Get Milli.gold's current fees for buying, selling, transferring and delivering gold and for wallet withdrawals.

Each fee is percent of the amount, at least min and at most max ('none' = no cap); mg = milligrams of gold. To price a concrete trade use mg_trade_quote.

Inputs: customer.

mg_get_priceMilli.gold live gold priceA
Read-onlyIdempotent

Get the current Milli.gold price of 18k melted gold, in Rial per milligram and per gram.

Platform's own price, no tax or making charge. For trends use mg_price_history.

Inputs: no named parameters.

mg_help_topicsMilli.gold help topicsA
Read-onlyIdempotent

Find Milli.gold help-center articles (how to buy, sell, deliver, transfer, verify, fees) by English keyword.

About 80 Persian articles with English URLs, so match on English words. Read one with mg_read.

Inputs: query.

mg_latest_postsMilli.gold latest postsA
Read-onlyIdempotent

List the newest posts on Milli.gold's news, magazine or help site, with date, categories, summary and URL.

Persian text. Only the newest posts exist (about 20 news, 10 mag, 10 help). Read one with mg_read.

Inputs: limit, section.

mg_platform_statsMilli.gold platform statisticsA
Read-onlyIdempotent

Get Milli.gold's headline numbers: users, trades, gold traded, gold held and branches.

Rounded totals the company publishes; weights in kilograms.

Inputs: no named parameters.

mg_price_historyMilli.gold price historyA
Read-onlyIdempotent

Get the Milli.gold 18k gold price series for a day, week or month, with high, low and change.

Rial per milligram: multiply by 100 for Toman per gram. time is Tehran time.

Inputs: period, points.

mg_readMilli.gold read postA
Read-onlyIdempotent

Read the text of one Milli.gold news, magazine or help post, with tables flattened to 'a | b | c' lines.

Persian text; only milli.gold news, mag and help URLs.

Inputs: url (required), max_chars.

mg_trade_quoteMilli.gold trade cost quoteA
Read-onlyIdempotent

Estimate what a gold trade on Milli.gold costs or pays out right now, fee included, at the live price.

Give grams (buy or sale) or toman (buy budget). Returns pay_toman for a buy, receive_toman for a sale. Estimate only: new-user fee waivers and withdrawal fees are not applied. Fee table: mg_fees.

Inputs: side (required), grams, toman.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools are cleanly separated: mg_get_price (current price) vs mg_price_history (series), mg_fees (fee table) vs mg_trade_quote (concrete trade calculation), and mg_read (fetch one document) are explicitly distinguished in their descriptions. The one soft overlap is between mg_latest_posts and mg_help_topics, since 'newest help posts' and 'find help articles by keyword' both surface the same content pool, though listing vs keyword search keeps them mostly distinguishable.

    Naming Consistency4/5

    All names share a consistent mg_ prefix and snake_case convention, making the set immediately recognizable. The suffix style varies slightly (verb forms like get_price and read versus noun phrases like price_history, platform_stats, fees), but the pattern is readable and internally predictable.

    Tool Count5/5

    Eight tools are well-scoped for a data/read-only API about one platform's gold pricing, stats, fees and content. Each tool earns its place with no redundant entries or obvious filler.

    Completeness4/5

    The surface covers pricing (current and historical), platform statistics, fees, trade estimation, and content discovery/reading, with sensible cross-references between fees and quotes and between listing and reading. Minor gaps remain: no keyword search for news/magazine posts (only help has search), and content access is limited to the newest ~20 news / 10 mag posts, but agents can work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      An MCP server that brings public gold (XAUUSD) market data into Claude, ChatGPT, and other MCP clients. Free tier includes 13 tools for price, OHLCV, macro context, correlations, and more.
      13
      47 PyPI
      9
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to read Tehran Stock Exchange and Iran Fara Bourse market data—quotes, top movers, order books, price history, sector indices, and real vs legal trading—through read-only tools. Requires no API key, returning compact JSON in Rial directly to Claude, Cursor, or Copilot.
      8
      239 PyPI
      7
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to fetch live gold, silver, platinum, and palladium prices by karat and currency, calculate jewelry melt value, and convert exact gold weight units such as tola, troy ounce, and Thai baht.
      4
      48 npm
      MIT