Iran Crypto Exchanges

For AI agents

• What: unofficial MCP server for the public market data of 12 Iranian crypto exchanges and brokers (Nobitex, Wallex, Bitpin, Ramzinex, Tabdeal, OMPFinex, Exir, Bit24, Aban Tether, Kifpool, OK-EX, Tetherland).
• Install: uvx iran-crypto-mcp or claude mcp add iran-crypto -- uvx iran-crypto-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional IRAN_CRYPTO_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
• Access: read-only. No login, balances, orders or trading, so no confirmation is needed before calling any tool.
• Tools: 8, all prefixed ic_. Start with ic_compare_price. Typical sequence: ic_compare_price -> ic_get_orderbook -> ic_candles.
• Use when: comparing a coin's price across Iranian exchanges, checking a spread, reading an order book or recent trades, or listing 24h movers.
• Do not use when: the user wants to buy, sell or transfer, needs account data, or wants non-Iranian exchanges.
• Output: compact JSON. Every IRT price is in Toman (field names say *_toman); USDT markets say *_usdt.
• Machine-readable: server.json and the iran-mcp catalog.

Why

• Rial vs Toman. Nobitex, Ramzinex and OMPFinex publish Rial; Wallex, Bitpin, Tabdeal and Exir publish Toman. The same BTC price differs 10x between them. This server converts everything to Toman, so the numbers compare directly.
• Seven sites to check by hand. Each exchange has its own app, its own symbols and its own API shape. One call to ic_compare_price returns the coin on every exchange, cheapest first, with the spread.
• Persian names. Every exchange row carries name_fa, the exchange's own Persian name, so answers in Persian do not depend on the model spelling it.

What it can do

• Compare one coin's price on all twelve exchanges, in Toman or USDT, cheapest first, with the spread
• Get a ticker: last price, 24h range and change, volume, and best bid/ask where the exchange publishes them
• Read order books (up to 20 levels per side) and recent public trades
• Pull OHLC candles (15m, 1h, 4h, 1d) from all eight order-book exchanges (and Aban Tether for USDT/IRT)
• Rank the biggest 24h gainers and losers on an exchange, with illiquid coins filtered out
• List the coins an exchange trades against Toman or USDT
• Find the best exchange for a buy or sell of a given size, walking each order book for slippage
• Scan all coins for price gaps between exchanges (arbitrage), on real bid/ask prices
• Compare trading fees and each coin's withdrawal networks, fees and minimums across exchanges
• Get a one-call market overview: the Tether rate and major coins, median price and range across exchanges

Example prompts:

• "Compare the BTC price on all Iranian exchanges in Toman. Where is it cheapest?"
• "What is the Tether (USDT) rate in Toman on each exchange right now?"
• "Show the Nobitex ETH order book. Is the spread real?"
• "Top 5 gainers on Wallex in the last 24 hours."
• "Give me 1-hour BTC candles from Wallex for the last two days."
• "Where do I get the most USDT for 50 million Toman?"
• "Which exchange has the cheapest USDT withdrawal on TRC20?"
• "Any arbitrage between Iranian exchanges right now?"
• با ۵۰ میلیون تومان کجا بیشترین تتر را می‌گیرم؟
• قیمت بیت‌کوین را در همه صرافی‌های ایرانی به تومان مقایسه کن.
• قیمت تتر الان در کدام صرافی ارزان‌تر است؟
• دفتر سفارش اتریوم در نوبیتکس را نشان بده.

Supported exchanges

• All twelve give prices in both quotes: Toman (IRT) and USDT. USDT markets stay in USDT.
• "Full" means last price, bid, ask, 24h high and low, change and volume.
• Bitpin volume comes from a best-effort second call; if it fails, the ticker has no volume.
• Exir publishes base volume only, so quote volume is approximated as volume times last price.
• Use ic_get_orderbook for the best bid and ask where the ticker lacks them.
• Nobitex refuses USDT/IRT candles (its CDN answers HTTP 403, browsers included): use Wallex for those.
• ic_fees: every exchange has trading fees; all but Aban Tether and OK-EX also publish withdrawal networks and fees. Ramzinex, OMPFinex, Bit24, Aban Tether and Tetherland publish trading fees only on a web page, so those values are fixed in the server (checked 2026-10-28).

Quick start

You need uv. No API key or account.

claude mcp add iran-crypto -- uvx iran-crypto-mcp

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

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

codex mcp add iran-crypto -- uvx iran-crypto-mcp

[mcp_servers.iran-crypto]command = "uvx"args = ["iran-crypto-mcp"]

gemini mcp add iran-crypto uvx iran-crypto-mcp

Tools

All 8 tools are read-only. Exchange ids: nobitex, wallex, bitpin, ramzinex, tabdeal, ompfinex, exir. quote is IRT (Toman, default) or USDT.

How it works

  AI agent  (Claude, Cursor, Copilot, ...)      │      │  MCP over stdio      ▼  iran-crypto-mcp  (runs on your machine)      │      │  HTTPS      └──────▶  public market-data endpoints of the 12 exchanges

• Runs locally and calls the public endpoints the exchanges' own websites use. No hosted server in between, no API key.
• Uses a Chrome-like HTTP client and sends each exchange's own Origin and Referer, like its website does.
• Answers are cached for 15 seconds and at most 2 requests run at once. Failed GET requests are retried.
• Read-only: it never calls account, order or trading endpoints.

Good to know

• Units are normalized. IRT prices are Toman (Rial exchanges are divided by 10); USDT prices are unchanged. The unit is in the field name: price_toman, price_usdt.
• name_fa on every exchange row is the exchange's own Persian name.
• One exchange can fail alone. ic_compare_price reports a failing exchange under errors and still compares the rest. HTTP 403 means that exchange's CDN refuses your network. Set IRAN_CRYPTO_MCP_PROXY to an Iranian HTTP proxy and try again.
• A spread is not always real. Quotes differ for real reasons (fees, liquidity, a stale last trade). Check the order book on both exchanges before acting on it.
• Reply sizes are capped to stay under about 15 KB: order books 20 levels, trades 50, candles 100, movers 25.
• Top movers skip coins below a 24h volume floor (default 100,000,000 Toman or 10,000 USDT; set min_volume to change it). Tabdeal publishes no volume, so its coins are not filtered.
• Prices are informational. They are live-ish (15 s cache), not a quote you can trade at.

FAQ

Configuration

فارسی

claude mcp add iran-crypto -- uvx iran-crypto-mcp

Development

git clone https://github.com/sepehr071/iran-crypto-mcp && cd iran-crypto-mcpuv syncuv run ruff check . && uv run ruff format --check .uv run python -m pytest -q          # offline unit testsuv run python -m pytest -m live -q  # calls the real exchange APIsuv build

Tools live in src/iran_crypto_mcp/markets.py, the per-exchange adapters in exchanges.py. Issues and PRs are welcome. Releases: bump the version in pyproject.toml and server.json, then push a v* tag.

Related servers

• iran-mcp: catalog of all Iranian-service MCP servers
• tgju-mcp for dollar, gold, coin and commodity prices from TGJU
• tsetmc-mcp for the Tehran stock exchange
• milligold-mcp for gold prices
• iran-news-mcp for Iranian news
• Listed on mcpfarsi.ir, the Persian MCP marketplace

Disclaimer

Unofficial and not affiliated with or endorsed by any exchange. It reads public market data only: no keys, no account access, no trading. Prices are informational, not financial advice, and the endpoints can change without notice.

Author

[Sepehr Radmard: open-source MCP servers for the Iranian web. LinkedIn: linkedin.com/in/sepehr-radmard]

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