sepehr071/iran-crypto-mcp

---

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.

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-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 the real exchange APIs
uv 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

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