milligold-mcp
This read-only Milli.gold MCP server lets an agent fetch live 18k gold prices, historical price trends, and platform statistics.
Get the current Milli.gold 18k gold price in Rial per milligram and per gram, with a Tehran-time timestamp.
Get daily, weekly, or monthly price history with high, low, change, and a configurable number of points (2–50).
Get platform statistics: users, trades, gold traded, gold held, and branches.
Read-only/no auth: it cannot buy, sell, log in, or access a wallet.
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., "@milligold-mcp What's the current 18k gold price per gram on Milli.gold?"
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.
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-mcporclaude 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_postsormg_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.jsonand 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-mcpSettings → 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-mcpOr 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 |
| 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 |
| Gets the 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 |
| Gets the current fees for buying, selling, transferring and delivering gold and for wallet withdrawals ( |
| Estimates the cost of a buy or the payout of a sale at the live price, fee included ( |
| Lists the newest posts with date, categories, summary and URL ( |
| Finds help-center articles by English keyword (e.g. |
| Reads the text of one milli.gold news, magazine or help post ( |
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, postsmilligold-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
price18in 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_ofand historytimevalues 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.
pointsonly 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 |
| 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 buildTools 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
Available Tools
8 toolsmg_feesMilli.gold feesARead-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 priceARead-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 topicsARead-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 postsARead-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 statisticsARead-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 historyARead-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 postARead-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 quoteARead-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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Live Iran exchange rates, gold, crypto, and Toman market data for AI agents.
FiLot gives an AI assistant the world gold price per gram in your currency, the price on a past date, and zakat on gold. Each price comes with a signature and a link to check it. It also checks gold bar records and, for Indonesia, gives dealer buyback prices and gold tax. In public beta. No FiLot account needed.
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
Precious metals AI analyst with 12 tools — prices, portfolio, chat, receipts, and more.
Related MCP Servers
- AlicenseBqualityCmaintenanceAn 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.1347 PyPI9MIT

Arzbin MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceLive Iran exchange rates, gold, crypto, and Toman/Rial market data for AI agents.2MIT- AlicenseAqualityBmaintenanceEnables 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.8239 PyPI7MIT
- AlicenseAqualityBmaintenanceEnables 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.448 npmMIT